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PREFACE 

Getting Started With Batch (TOPS-10) has been written for you, if you 
have a rudimentary knowledge of Batch processing or are familiar with 
at least one of the following: 

1. a programming language 

2. the timesharing services of the DECsystem-10 

3. card processing on other systems 

HOW TO USE THIS MANUAL 

If you input your jobs through interactive terminals, the following 
chapters are recommended: 

Chapter 1 Introduction 

Chapter 2 Entering a Batch Job from a Terminal 

Chapter 4 Interpreting Your Printed Output, Section 4.4.1 

Chapter 5 Using the Terminal to Enter Jobs, Section 5.1 

If you input your jobs from cards, the following chapters are 
recommended: 

Chapter 1 Introduction 

Chapter 3 Entering a Batch Job from Cards 

Chapter 4 Interpreting Your Printed Output, Section 4.4.2 

Chapter 5 Using Cards to Enter Jobs, Section 5.2 
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REFERENCES 



Not all of the commands and card formats for Batch processing are 
described in this manual. If you want to know more about Batch you 
can refer to the DECsystem-10 (TOPS-10) Batch Reference Manual. In 
addition, all components of Batch processing are referred to as Batch 
in this manual. For a complete description of these components, refer 
to the DECsystem-10 (TOPS-10) Batch Reference Manual. 

An elementary description of the basic TOPS-10 system commands can be 
found in the documents Getting Started With DECsystem-10 (TOPS-10) and 
Getting Started With TOPS-10 Commands. The DECsystem-10 (TOPS-10) 
Operating System Commands Manual contains additional descriptions of 
the TOPS-10 commands available to you. 

Error messages that occur while Batch is processing but which are not 
defined in this manual are explained in applicable system manuals. 
For example, if your FORTRAN program fails to compile successfully, 
the error message you receive from the FORTRAN compiler can be found 
in the FORTRAN-10 Programmer's Reference Manual. For errors that may 
occur in a Batch process but not in the source program being used, you 
can refer to the DECsystem-10 (TOPS-10) Batch Reference Manual. 



CONVENTIONS USED IN THIS MANUAL 



The following is a list 
manual. 



dd-mmm-yy hh:mm 



of symbols and conventions used in this 



A set of alphanumeric characters that indicates 
date and time; e.g., 2-APR-78 15:30. Time of day 
is represented by a 24-hour notation; 15:30 means 
3:30 P.M. 



filename. ext 



The filename and file extension of a file. The 
filename can be 1 to 6 alphanumeric characters in 
length and the file extension can be 1 to 3 
alphanumeric characters in length. The file 
extension may be optional. If present, the file 
extension must be separated from the filename with 
a period. Refer to the Glossary for the 
definitions of these terms. 



hh:mm:ss 



jobname 



[proj,prog] 



A set of numbers representing time in the form 
hours:minutes:seconds. Leading zeros can be 
omitted, but colons must be present between two 
numbers. For example, 5:35:20 means 5 hours, 35 
minutes, and 20 seconds. 

The name that is assigned to a job. It can 
contain up to six characters. Refer to the 
Glossary for the definition of a job. 

A number that specifies either a required number 
or an amount of things such as cards or 
line-printer pages. This number can contain as 
many digits as are necessary to specify the amount 
required, e.g., 5, 13, 219, etc. 

The user number assigned to each user, commonly 
called a project-programmer number. The two 
numbers that make up the project-programmer number 
must be separated by a comma. Refer to the 
Glossary for the definition of a 
project-programmer number. 

A number representing an amount of time, usually 
in minutes. This number can contain as many 
digits as are necessary to specify the amount of 
time required, e.g., 7, 40, 120, etc. 

An alphanumeric character. 
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SYMBOLS USED IN THIS MANUAL 



Symbol 


Meaning 


.TYPE 


Anything you type on your terminal appears in red. 
Anything the system prints on your terminal appears 
in black. 


QE) 


Press the key labeled RETURN or CR. 


QiT) 


Press the key labeled DELETE or RUBOUT. 


( oQ 


Press the key labeled ESC, ESCAPE, ALT, or PRE. 


( TAB ) 


Press the key labeled TAB. 


no 


Press the space bar once. 


[ i 


Brackets enclose all optional arguments. 


( ) 


Parentheses enclose the name or value of an argument. 
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CHAPTER 1 
INTRODUCTION 



1.1 WHAT BATCH IS 

Many data processing jobs may require long running times and may make 
few demands of you. Ideally these jobs should be run in your absence 
when the computer is not busy with other tasks. This ideal is met by 
the TOPS-10 Batch system. 

Batch is a group of- programs that allows you to submit a job to the 
TOPS-10 system on a leave-it basis. (Refer to the DECsystem-10 
(TOPS-10) Batch Reference Manual for a complete description of 
programs that constitute the Batch system.) You may build and submit 
your job in one of two ways: 

1. By entering your data directly to an interactive computer 
system by means of a timesharing terminal. 

2. By entering your data from punched-cards to the interactive 
system. The cards are given to an operator who, at an 
appropriate time in his schedule, enters them into the 
computer through a card reader. 

One advantage of Batch processing with an interactive system is that 
the interactive capabilities may be employed to greatly reduce the 
amount of time required to prepare the job for entry. By using a 
terminal to enter and edit the program items and data to be processed, 
you can bypass the tedious chore of preparing card decks. However, if 
desired, you can prepare traditional card decks by employing the 
punched card facilities of the system. In either case, the 
information to be entered is prepared as if it were to be processed as 
a normal job from an interactive terminal. The only added requirement 
is that special commands are entered with the job to direct the system 
in your absence. In other words, you anticipate the questions the 
system normally asks and you answer them when you enter the 
interactive job. 

After preparing the job, you are free to leave the system. Upon 
accepting the job, the system classifies it in terms of size, running 
time, the need for peripherals, etc. This classification is used as 
the basis for determining when the job is to be run. Large jobs may, 
therefore, be set aside until smaller or more urgent jobs are 
finished. 
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INTRODUCTION 

Some of the jobs that are commonly processed through the TOPS-10 Batch 
system are those that: 

1. are frequently run for production 

2. are large and long running 

3. require large amounts of data 

4. need no actions by you when the jobs are running 

Batch allows you to submit your job to the computer through either a 
card deck given to an operator or a timesharing terminal, and to 
receive your output from the operator when the job has finished. 
Output is never returned to your timesharing terminal even if your job 
is entered from one. Instead, it is sent to a peripheral device 
(normally the line printer) at the computer site and returned to you 
in the manner designated by the installation manager. 



1.2 HOW TO USE BATCH 

To use the Batch system to process your job, you must create a- control 
file. A control file consists of various commands that tell the 
TOPS-10 system what you want to process. The control file commands 
can be created as a disk file or as card input and can consist of: 

1. System commands (see the DECsystem-10 (TOPS-10) Operating 
System Commands Manual) , 

2. System program commands to system programs, and 

3. Batch commands (see Chapters 2 and 3) . 

These commands, when submitted to the operating system, must be in a 
particular order so that your Batch job will execute correctly. 

The steps that you must take to create a control file from a 
timesharing terminal are described in Chapter 2. The steps to take to 
create a control file from cards are described in Chapter 3. 



1.2.1 Running Your Job 

After you submit the job, it waits in a queue with other jobs until 
Batch schedules it to run under guidelines established by the 
installation manager. Several factors affect how long your job waits 
in the queue, for example, its estimated execution time and the 
priority of your job compared with other waiting jobs. 

When the job is started, Batch reads the control file to determine 
what actions are necessary to complete the job. For example, if there 
are commands to the system programs, Batch issues the commands to 
those programs. Any output produced as a result of those commands is 
stored in a log file for listing later. With adequate planning, the 
control file can also provide for corrective actions in the event of 
errors. 
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As each step in the control file is performed, Batch records it in a 
log file. For example, if a system command such as COMPILE is 
executed, Batch passes it to the system and writes it in the log file. 
The system response is also written in the log file. Batch writes in 
the log file any response from your job that would have been written 
on the terminal if the job had run interactively. 



1.2.2 Receiving Your Output 

Your program output will be returned to you in the form that you 
specified by the commands in your control file. This is normally the 
line-printer listing, but may also be output on magnetic tape, disk, 
DECtape, or cards. When your output is directed to the line printer, 
you may specify the approximate number pf pages that you require (to 
help Batch restrain runaway programs) . 

If your Batch job is submitted through a timesharing terminal, the log 
file is written and saved on disk in your directory and printed on the 
line printer. If your Batch job is submitted on card input, the log 
file is written on disk in your directory, printed on the line 
printer, and then deleted from your directory. 



1.2.3 Recovering from Errors 

If an error occurs in your job, either within a program that is 
executing or within the control file, Batch writes the error message 
in the log file and usually terminates the job. You can, however, 
include commands in the control file to direct Batch to branch to 
recovery sequences in the event of an error and thereby allow 
completion of the job. The effectiveness of error recovery is 
dependent on your ability to predict potential trouble spots within 
the program or within commands used in the control file. (Refer to 
the DECsystem-10 (T0PS-1G) Batch Reference Manual for detailed 
descriptions on error recovery for Batch jobs.) 



1 . 3 SUMMARY 

The steps that you must perform to enter a job to the computer through 
Batch are as follows: 

1. Create a control file either on cards or from a terminal, 

2. Submit the job to Batch, either indirectly via the operator 
(for a card job) or directly from a terminal. 

3. Obtain and examine the log file listing and the job output to 
determine if the desired results were obtained. 

Sample jobs run through Batch from cards and from a terminal are shown 
in Chapter 5. 
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CHAPTER 2 
ENTERING A BATCH JOB FROM A TERMINAL 



When you submit a job to Batch from a timesharing terminal, you must 
create a control file that Batch can use to run your job. The control 
file contains all the commands that you would use to run your job if 
you were running under timesharing. For example, if you wanted to 
compile and execute a program called MYPROG.CBL, the typeout on a 
timesharing terminal would appear as follows: 



♦ COMPILE MYPROG .CBI-O^O 
COBOL: MYPROG C MYPROG.CBL 3 

EXIT 

.EXECUTE MYPROG.CBL GID 

LINK J LOADING 

CLNKXCT MYPROG EXECUTIONS 

EXIT 



(Your request) 

(The system's reply) 

(Your request) 

(The system's reply) 



To create a control file to tell Batch to run the same, you would 
create the following: 



* 



.SOS MYFILE.CTLl »» 

INPUT? MYPILE.CTL 

.COMPILE MYPROG. CBL G»D 
♦EXECUTE MYPROG.CBL' 



00100 
00200 
00300 



GeD 



*e CUD 



LDSKCJMYFILE.CTL3 



When the job is run, the commands are passed to the system to be 
executed. The commands and their replies from the system are written 
in the log file so that the entire dialogue shown in the first example 
above appears in the log file. 
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ENTERING A BATCH JOB FROM A TERMINAL 



2.1 CREATING THE CONTROL FILE 

To create a control file and submit it to Batch from a terminal, you 
must perform the following steps: 

1. LOGIN to the system as a timesharing user. 

2. Create a control file on disk using SOS (or TECO) . 

3. Submit the job to Batch using the system command SUBMIT. 

You can then wait for your output to be returned at the designated 
place . 

After you have logged into the system as you normally would to start a 
timesharing job, you can use SOS (or TECO) to create your control 
file. 

The control file can contain TOPS-10 Monitor commands, program 
commands, data that would normally be entered from a terminal, and 
Batch commands. The Batch commands are described in Section 2.3. 
What you write in the control file depends on what you wish your job 
to accomplish. An example of a job that you can enter for Batch 
processing is as follows: 

1. Compile a program that is on disk. 

2. Load and execute the program using data from a file already 
on disk. 

3. Print the output on the line printer. 

4. Write the output into a disk file also. 

5. Compile a second program. 

6. Load and execute the second program using the data output 
from the first program. 

7. Print the output from the second program. 

The control file that you would create for the preceding job would 
appear as follows: 



,sos myfile»ctlGilD 
input: myfile.ctl 

00100 ♦COMPILE MYPROG. FOR/COMPILE Qet 
00200 . EXECUTE MYPROG ♦F0RQh3 
00300 ♦COMPILE PR0G2 .FOR/COMPILE CUD 
00400 .EXECUTE PR0G2.F0RQlD 
00500 * 
t 

#E ( Rtl ) 



CDSKC:MYFILE.CTL3 
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ENTERING A BATCH JOB FROM A TERMINAL 

Include statements in your programs (rather than in the control file) 
to read the data from the disk files and write the output to the 
printer and the disk. The output to the line printer is written along 
with your log file as part of the total output of your job. 

If an error occurs in your job, Batch will not continue but will 
terminate the job. To avoid having your job terminated because an 
error occurs, you can specify error recovery in the control file using 
special Batch commands. Error recovery is described in Section 2.4. 

Any system command that you can use in a timesharing job can be used 
in a Batch job with the following exceptions. The ATTACH and SET TIME 
commands are illegal in a Batch job. If you include either of these 
commands in your job, Batch will process the command and the monitor 
will place an error message into your log file. Your Batch job will 
terminate unless you specify error recovery. 

Do not include a LOGIN command in your control file since Batch logs 
the job for you. If you put in a LOGIN command, your job will be 
terminated. In addition, you do not need to include a KJOB command. 
Batch will log out your job automatically when it reaches the end of 
your control file. 



2.1.1 Format of Lines in the Control Pile 

Since you can put TOPS-10 monitor commands, program commands, and 
Batch commands, as well as data, into the control file, you have to 
tell Batch what kind of line it is reading. Batch determines the line 
it is reading as a command, data, or comment by the first nontab or 
nonblank character. The first character in each line should be one of 
the characters described below. 

To put a system command or Batch command into your control file, you 
must put a period (.) in the first column and follow it immediately 
with the command. 

To put a command string of a system program or user program into your 
control file, put an asterisk (*) in column 1 and follow it 
immediately with the command string. For the format of the command 
string, refer to the manual for the specific program that you wish to 
use. 

If you want to include in the control file a command to a system 
program that does not accept a carriage return as the end of the line, 
e.g., DDT, you must substitute an equal sign (=) for the asterisk so 
that Batch will suppress the carriage return at the end of the line. 

To include data for your program in the control file, write it as you 
would input data from a separate file. The asterisk (*) should always 
be the first character before each line of data input. The asterisk 
(*) tells Batch that this line is input data to your program. 

Comments can also be included in the control file either as separate 
lines or on lines containing other information. To include a comment 
on a separate line, you must put an exclamation point (i) in column 1 
and follow it with the comment. To add a comment to a line after your 
data, you must precede the comment with an exclamation point (!). 
Refer to the manual that describes the program you are using, as some 
programs and their input do not accept comments preceded by the 
exclamation point (!). 
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To include a CTRL/C in your control file, type an up-arrow and a C 
(~C) . To include an ESCape (altmode) , type an up-arrow and a left 
square bracket ("[). 

If you put in the first column of the line any special characters 
other than those described, you may get unexpected results because 
Batch interprets other special characters in special ways. 

The following example illustrates a control file, using some of the 
characters described above, and the resulting log file. The example 
uses the TOPS-10 FILCOM utility to compare two files. 

!This batch job generates a FILCOM of two files. 

!Run FILCOM and then give it a command. 

.R FILCOM 

*TTY : =FILE . QXT , FILE .TXT 

*~C 



08 


I48| 


08 


1481 


08 


(48 | 


08 


1481 


08 


1481 


08 


1481 


08 


1481 


08 


1481 


08 


1481 


08 


I48l 


08 


1 49 I 


08 


1 48 a 


08 


r 48 1 


08 


1 48 a 


08 


481 


08 


1481 


08 


1481 


08 


>48l 


08 


481 


081 


481 


08 


148 | 


081 


481 


08 


481 


08 


148 1 


08 


1 48 8 


08 


148 I 


08 


1 48 I 


08 


1481 


08 


1481 


08 


481 


08 


1 48 1 


08 


481 


08 


1481 


08 


148 a 


814811 


014811 



07 BAJOB 

07 BAFIL 

07 BAFIL 

07 BASUM 



07 MONTH 

07 MQNTP 

07 USEP 

09 USEP 

09 USEP 

10 MONTP 
10 MONTP 



10 MONTR 

10 USEP 

11 USEP 
11 USEP 
11 USER 
11 USER 
11 USER 
11 USER 
11 USER 
11 USEP 
11 USER 
11 USER 
11 USER 
U USER 
11 USER 
11 MONTR 
It MONTR 
11 USER 
11 USER 
13 USER 
13 USER 
13 USER 
13 USEP 

4 LPDAT 
4 LPDAT 



BATCON vtraion 103(2207) running EXAM2 faqutnct 8902 in ttrtam 1 
input from DSKClEXAM2,CTl[27,5107] 
Output to DSKCIEXAM2,L0G[27,5107} 

Job paramtttrt 

Tlmt|00|05l00 UntquttYES RtttartiNO OutputiLQG 

.LOGIN 27/5107 /DEFER/SPOOL | ALL/TIME I 300/LOCATE 1 26/NAMEl «BH0WN,E" 
JOB 42 PZ376B *L10 SY5M026 TTY453 
[LGNJSP othtr Jobf •«!"# PPM29J 

0848 01*Aug*78 Tut 



JThii Batch job gtntrattt • FILCOM of t«o mat, 
IPun FILCOM and than givt it a command, 
,R FILCOM 



•♦TTyiaFlLE.TST^ILE.TXT 

Flit 1) DSKClFlLE,TSTt27|5107] Crtattdl 0846 01*A U 9"l978 

Flla 2) DSKCIFILE,TXTC27,5107] ertattdl 0846 0UAu9*1979 

1)1 This flu contain! a §Ptlln9 trror, 

2)1 This flu oott not eontaln a •palling arrori 



Itlltt art dlfftrtnt 

#a*C 

,,KJqB/BATCH 

[LGTaJL Anothtr job 18 itlll loggtd«ln undtr (27,5107) J 
Job 42 Uttr BROWN, E 127,5107} 
Loggtd»o*f TTY453 at 8t48ll3 on l«Aug«78 
Runtlmai OiooiOo, KCS14, Conntct timtt O1001O6 
DISK Rtadn69, Wrlttll7 

LPTSPL vtrilon 103(2421) RZ37bB KL10 SYSU026 

Job EXAM2 Itqutnct #59o2 on LPT261 AT 1-AU9-78 8148114 
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ENTERING A BATCH JOB FROM A TERMINAL 

2.2 SUBMITTING THE JOB TO BATCH 

After you have created the control file and saved it on disk, you must 
enter it into the Batch queue so that it can be run. All programs and 
data that are to be processed when the job is run must be made up in 
advance or be generated during the running of the job. You can have 
them on magnetic tape, but if you do, you must include the TOPS-10 
commands MOUNT arid DISMOUNT in your control file so that the operator 
will mount and dismount the tape(s) to be read. (Refer to Chapter 5 
for examples of a control file with these commands.) 

If your programs and data reside on an on-line disk, you need not 
include the MOUNT and DISMOUNT command as there is no action required 
by the operator. 

You enter your job in Batch's queue by means of the TOPS-10 SUBMIT 
command. This command has the form: 

.SUBMIT jobname=control-f ilnam.ext/switches,log-f ilnam.ext/switches 

jobname is the name that you give to your job. If 

this name is omitted, the monitor uses the 
name of the log file (log-f ilnam.ext) . 

control-f ilnam.ext is the name that you have given to the 

control file you created. You can add a file 
extension (.ext), but if you do not, Batch 
will assume a file extension of .CTL. 

log-f ilnam.ext is the name of the log file that Batch will 

use. You can add a file extension (.ext), 
but if you do not, Batch will assume a file 
extension of .LOG. 

You must specify the name of the control file. If the name of the log 
file is omitted, its name will be taken from the name of the control 
file. 

/switches are switches to Batch to tell it how to 

process your job and what your output will 
look like. Most switches can appear anywhere 
in the SUBMIT command string; however, a few 
must be placed after the files to which they 
pertain. The various kinds of switches are 
described below. 

Three categories of switches are available to you when you use the 
SUBMIT command to process your Batch job. These three categories are: 

1. Queue-Operation switches, 

2. General switches, and 

3. File-Control switches. 

Only one of the Queue-Operation switches can be placed in the command 
string because this category defines the type of queue request. The 
switch used can appear anywhere in the command string. Refer to the 
DECsystem-10 (TOPS-10) Batch Reference Manual and/or the DECsystem-10 
(TOPS-10) Operating System Commands Manual for a complete list of 
Queue-Operation switches in the SUBMIT command. 
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2.2.1 General Switches 

You use the general switches to define limits for your job. Such 
limits as pages of output and the time that your job will run can be 
specified as general switches. Each general switch can be specified 
only once in a SUBMIT command. You can put a switch anywhere in the 
command string. 

/AFTER: hh: mm Switch 

If you do not want Batch to run your job until after a certain time or 
until after a certain number of minutes have elapsed since the job was 
entered, you can include the /AFTER switch in the SUBMIT command 
string. To run the job after a specified time of the day, you must 
specify the time in the form hh:mm (for example, /AFTER: 12: 00 to run a 
job after noon) . To run the job after a given amount of time has 
elapsed, specify the time in the form +hh:mm (for example, 
/AFTER:+1:00 to run the job an hour from now). If you omit the 
switch, Batch will schedule your job as it normally would using its 
defaults. If you omit the colon and/or value, the monitor will 
respond with an error message and terminate the SUBMIT command. 

/PAGE:n Switch 

Normally, Batch allows your job to print up to 200 pages. Included in 
this number are the log file and any compilation listings that you may 
request. If you need more than 200 pages for your job, you must 
include the /PAGE switch in the SUBMIT command to indicate the 
approximate number of pages that your job will print. If you include 
the switch without the colon and a value, the monitor will assume that 
you will print up to 2000 pages. If your output exceeds the number 
that you specified in the /PAGE switch, the excess output will be lost 
and the message 7LPTPLE Page Limit Exceeded will be printed. 
However, even if you exceed the maximum, the first 10 pages of the log 
file will be printed. 

/TIME:hh:mm:ss Switch 

Normally, Batch allows your job to use up to five minutes of central 
processor time. Central processor (CPU) time is the amount of time 
that your job runs, not the amount of time that it takes Batch to 
process your job. If you need more than five minutes of CPU time, you 
must include the /TIME switch in the SUBMIT command to indicate the 
approximate amount of time that you will need. If you specify the 
switch without the colon and a value, Batch will assume that you need 
one hour of CPU time. If you do not specify enough time, Batch will 
terminate your job when the time is up. 

The value in the /TIME switch is given in the form hh:mm:ss 
(hours:minutes: seconds) . If you specify only one number, Batch 
assumes that you mean seconds. Two numbers separated by a colon are 
assumed to mean minutes and seconds. All three numbers, separated by 
colons, mean hours, minutes, and seconds. For example: 

/TIME:25 means 25 seconds 

/TIME:1:25 means 1 minute and 25 seconds 

/TIME :1 :25 :00 means 1 hour and 25 minutes and no seconds 
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2.2.2 File-Control Switches 

File-control switches allow you to specify parameters for individual 
files in the SUBMIT command. The control file can receive a special 
parameter, while the log file does not, and vice versa. If you place 
a file-control switch before the two filenames in the SUBMIT command, 
the switch applies to both files in the request. If you place the 
switch after one of the files in the command, it refers only to that 
file. 

The switches, and the assumptions made if they or their values are 
omitted, are all subject to change by each installation. Check with 
the installation where you run your jobs to find out what differences 
exist between the values described here and those at the installation. 
Additional switches available for use with the SUBMIT command are 
defined in the DECsystem--10 (TOPS-10) Batch Reference Manual and the 
DECsystem-10 (TOPS-10) Operating System Commands Manual. 



2.2.3 Examples of Submitting Jobs 

The following are sample jobs entered to Batch by means of the SUBMIT 
command . 

Example 1: 

This control file consists of commands to compile FORTRAN 
program, print a listing, and execute it. 

INPUT t MYFILE.CTL 

00100 .COMPILE MYPROG.FOR/LIST/COMPILEG»D 

00200 .EXECUTE MYPROG .FORGED 

00300 * 

( E SC ) 

#E'GiD 

CDSKC J MYFILE.CTL."! 



After the control file to compile and execute the FORTRAN program 
has been created and saved, you must submit the job to Batch. 

, SUBMIT MYFILE.CTL(j«D 

When the monitor reads this SUBMIT command, it assumes the 
following : 

1. The control filename and type are MYFILE.CTL. 

2. The name of the job is MYFILE. 

3. The log file will be named MYFILE.LOG. 

4. Both the control file and the log file will be saved in your 
disk area. 
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5. 200 is the maximum number of pages to be printed (/PAGE:200). 

6. The maximum amount of CPU time is 5 minutes (/TIME : 5: 00) . 

Example 2: 

The next example shows the control file that was created at the 
beginning of this chapter being submitte "" to Batch. 

.TYPE MYFILE.CTLGID 

00100 . COMPILE MYPROG. FOR/COMPILE 

00200 .EXECUTE MYPR0G.F0R 

00300 .COMPILE PR0G2. FOR/COMPILE 

00400 .EXECUTE PR0G2.F0R 

. 

After you have saved the control file, you can submit the job to 
Batch. 



.submit my job=myfile/time:20/page:750/after: io :ooGED 

When the monitor reads this request, it assumes the following: 

1. The name of the job is MYJOB. 

2. The name of the control file is MYFILE.CTL. 

3. The log file will be named MYFILE.LOG. 

4. The log file will be left in your disk area after it is 
printed . 

5. The control file will be left in your disk area. 

6. 750 is the maximum number of pages that can be printed 
(/PAGE:750) . 

7. The maximum amount of CPU time that the job can use is 20 
seconds (/TIME: 20). 

8. The job will be processed only after 10:00 A.M. 

If you made an error in the SUBMIT command when you submitted either 
of these jobs, the monitor will type an error message on your terminal 
to explain your error so that you can correct it. 



2.3 BATCH COMMANDS 

You can write certain Batch commands in the control file to tell Batch 
how to process your control file. Each of these commands must be 
preceded by a period (.) so that Batch will recognize it. The most 
commonly used Batch commands are described in the following sections, 
but not all Batch commands are described here. For a description of 
all commands, refer to the DECsystem-10 (TOPS-10) Batch Reference 
Manual . 
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2.3.1 The .IF Command 

You can include the .IF command in your control file to specify an 
error-recovery procedure to Batch or to specify normal processing if 
an error does not occur. The .IF statement has the forms: 

.IF (ERROR) statement (The parentheses must be included.) 

.IF (NOERROR) statement (The parentheses must be included.) 

where 

statement is a command to the system, to a program, or to 
Batch,, 

An example of the .IF (ERROR) command follows: 

!DO A DIRECTORY IF AN ERROR OCCURS 
.IF (ERROR) .DIRECT/ALLOC 



An example of the .IF (NOERROR) command follows: 

I IF NO ERROR OCCURS, GIVE A SECOND LINE OF INPUT 
.IF (NOERROR) *FILE . SCM=A . TXT ,B . TXT 

The .IF command can be used in two ways as shown in its two forms. 
You can include the .IF (ERROR) command in your control file at the 
place where you suspect an error may occur. The .IF (ERROR) command 
must be the next command in your control file (that is, the next line 
which begins with a period (.)) after an error occurs; otherwise, 
Batch will terminate your job. In the .IF (ERROR) command, you direct 
Batch to either go back or forward in your control file to find a line 
that will perform some task for you or that will direct the system or 
any other program to perform some task for you. 

You can use the .IF (NOERROR) command to direct Batch or the system to 
perform tasks for you when an error does not occur at the point in 
your control file where you place the .IF (NOERROR) command. Thus, if 
you expect that an error will occur in your program, you can include 
an .IF (NOERROR) command to direct Batch in case the error does not 
occur, and then put the error-processing lines immediately following 
the command. Refer to Section 2.4 for more examples of using .IF 
(NOERROR) and .IF (ERROR). 

If an error occurs and Batch does not find an .IF command as the next 
command line in the control file, Batch terminates the job. 



2.3.2 The .ERROR Command 

With the .ERROR command, you can specify to Batch the character that 
you wish to be recognized as the beginning of an error message. 
Normally, when Batch reads a message that begins with a question mark 
(?) , it assumes a fatal error has occurred and terminates the job 
unless you have specified error recovery (refer to Section 2.4). If 
you wish Batch to recognize another character (in addition to the 
question mark) as the beginning of a fatal error message, you must 
specify the character in the .ERROR command. The character specified 
may not be a control character, an exclamation point (!) or a 
semicolon (;) . The exclamation point is always interpreted as the 
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comment character and will not function as the error-signal character. 
This command has the form: 

.ERROR character 

where 

character is a single ASCII character 

If you do not specify a character in the .ERROR command, Batch uses 
only the standard error character, the question mark. When a line 
that begins with the character you specify in the .ERROR command is 
output to the Batch job by the system, a system program, or is issued 
by Batch itself, Batch treats the line as a fatal error and terminates 
the job, exactly as it would if the line were preceded by a question 
mark. Any messages preceded by other characters will not be 
recognized by Batch as errors. 

If you do not include the .ERROR command in your control file, Batch 
will recognize only the question mark as the beginning character of a 
fatal error message. 

An example of the .ERROR command follows. 



.ERROR % 



. ERROR 

In this example, you specify in the middle of the control file that 
you want Batch to recognize the question mark (?) and the percent sign 
(%) as the beginning character of a fatal error from that point in the 
control file. Further on in the control file, you tell Batch to go 
back to recognizing only the question mark as the beginning of a fatal 
error message. 



2.3.3 The .NOERROR Command 

You can use the .NOERROR command to tell Batch to ignore all error 
messages issued by the system, system programs, and Batch itself. The 
.NOERROR command has the form: 

.NOERROR 

When Batch reads the .NOERROR command, it ignores any error messages 
that would normally cause it to terminate your job. The only 
exception is the message ?TIME LIMIT EXCEEDED. Batch will always 
recognize this as an error message, give you an extra 10% of your 
allotted time, and terminate your job. 

You can use .NOERROR commands in conjunction with .ERROR commands in 
the control file to control error reporting. For example, if you wish 
to ignore errors at the beginning and end but not in the middle of the 
control file, place .ERROR and .NOERROR commands at the appropriate 
places in the control file. In addition, you can also specify which 
messages must be treated as fatal errors. 
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NOERROR 



ERROR % 



. ERROR 



.NOERROR 



The first command tells Batch to ignore all errors in your job. The 
second command tells Batch to recognize as errors any message that 
starts with a question mark (?) or a percent sign (%) . You change the 
error reporting with the next command to tell Batch to go back to 
recognizing only messages that begin with a question mark as fatal. 
The second .NOERROR command tells Batch to ignore all error messages 
again. If the ?TIME LIMIT EXCEEDED message is issued at any time, 
Batch will print the message, extend the time by 10%, and then 
terminate the job. 



2.3.4 The .GOTO Command 

You can include the .GOTO command in your control file to direct Batch 
to skip over lines in the control file to find a specific line. The 
.GOTO command has the form: 

.GOTO label 

where 

label is a one- to six-character alphanumeric label for a 
statement. The line that contains the label must be 
followed by two colons (::). 

An example of the .GOTO command follows. 



.GOTO ABC 



ABC: : .DIRECT 

You can use the .GOTO command as the statement in an .IF command 
(refer to Section 2.3.1) to aid you in error processing. For example: 



.IF (ERROR) .GOTO ABC 

ABC: : .TYPE MYPROG 
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When Batch encounters a .GOTO command in the control file, it searches 
forward in the control file to find the label specified in the .GOTO 
command. Batch then resumes processing of the control file at the 
line which has the specified label. If the label is not found, Batch 
will issue the message 

? BTNCNF Could not find label xxxxxx 

and the job will be terminated. 

If you do not include a .GOTO command in the control file, Batch reads 
the control file sequentially from the first statement to the last. 



2.3.5 The . BACKTO Command 

You can use the .BACKTO command to direct Batch to search back in the 
control file for a line with a specified label. The .BACKTO command 
has the form: 

.BACKTO label 

where 

label is a one- to six-character alphanumeric label for a 
statement. The line that contains the label must be 
followed by two colons (::). 

An example of the .BACKTO command follows. 



ABC: : .DIRECT 



.BACKTO ABC 

Normally, Batch reads the control file line by line and passes the 
commands and data to the system and your program. When you put a 
.BACKTO command into the control file, you tell Batch to interrupt the 
normal reading sequence and to search back in the control file to find 
a line containing the label specified in the .BACKTO command. The 
.BACKTO command searches for the label you specified, starting from 
the beginning of the file and ending at the place the command was 
given. When the labeled line is reached, Batch executes the line and 
continues from that point. 

If Batch cannot find the labeled line, it terminates your job. 



2.4 SPECIFYING ERROR RECOVERY IN THE CONTROL FILE 

If you do not specify error recovery when an error occurs in your job, 
Batch terminates the job. You can specify error recovery in the 
control file by means of the Batch commands, especially the .IF Batch 
command. If you wish to recover from errors while the job is 
processing, you must put the .IF command at the point between programs 
in the control file where an error may occur. When an error occurs, 
Batch skips over all lines in the control file until it encounters a 
line beginning with a period (.). If this line contains an .IF 
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command, the .IF command is processed and the job continues. If this 
line does not contain an .IF command, the job is terminated. 
Therefore, if a Batch job is to recover from an error successfully, 
the .IF command must be placed in the control file where the error is 
expected to occur but before any other commands preceded by the 
character. Thus, if you have a program that you are not sure is error 
free, you can include an .IF command to tell Batch what to do if an 
error occurs, as shown in the following example. 

.COMPILE MYPROG.FOR 
.IF (ERROR) statement 



In either the .IF (ERROR) or the .IF (NOERROR) command, you should 
include a statement that tells Batch what to do. You can use any 
monitor command or Batch command. The .GOTO and .BACKTO commands are 
also commonly used for this purpose. Refer to Sections 2.3.4 and 
2.3.5 for descriptions of these commands. Be sure, if you use .GOTO 
or .BACKTO in the .IF command, that you supply a line in the control 
file that has the label that you specified in the .GOTO or .BACKTO 
command. If you wish to simply ignore the error without taking any 
special action, you may use a comment as the statement. 

Two sample jobs are shown below. The first shows the .IF (ERROR) 
command and the .GOTO command to specify error recovery. The second 
example shows the use of the .IF (NOERROR) and .GOTO commands. 

If you have a program that you are not sure will compile without 
errors, you can include another version of the same program in your 
job (that hopefully will compile) and tell Batch to compile the second 
program if the first has an error. You would write the control file 
as follows. 

\ , v 

♦SOS MYFILE.CTLGED 

INPUT: MYFILE.CTL 

00100 .COMPILE /COMPILE MYPROG . FOR/LI STQ1D 

00200 .if (error) .goto a qid 

00300 .execute myprog .for ced 

00400 .goto bced 

00500 a:: icqntinueGjD 

00600 .compile /compile pr0g2.f0r/listgid 

00700 .execute pr0g2 .for god 

00800 B: J ! CONTINUE QfD 
00900 $ 
t 



*EQiD 
CDSKCJMYFILE.CTL3 



When the job is run, Batch reads the control file and passes commands 
to the system. If an error occurs in the compilation of the first 
program, Batch finds the .IF (ERROR) command and executes the .GOTO 
command contained in it. The .GOTO command tells Batch to look for 
the line labeled A::. Thus, Batch skips lines in the control file 
until it finds label A and then passes commands to the batch job from 
that point. If an error does not occur while compiling MYPROG, the 
.GOTO A statement is not executed. Instead, MYPROG is executed and 
then Batch skips to the line labeled B::. 
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A variation of the above procedure is shown below using the .IF 
(NOERROR) command and the .GOTO command. The difference is that Batch 
skips the .IF (NOERROR) command if an error does occur, and performs 
it if an error does not occur. The following is the control file that 
you would create. 



I 

♦sos myfile.ctlCmD 

input: myfile.ctl 

00100 f compile /compile m YPROG . FQR/LI STC^T 

00200 .IF (NOERROR) .GOTO AQllD 

00300 . COMPILE /COMPILE PR0G2 ♦ FOR/LISTQlD 

00400 .EXECUTE PR0G2. FORGED 

00500 .GOTO BQID 

00600 a: : icontinueGID 

00700 .EXECUTE MYPROG .FOR (TTT) 
00800 B: J ! CONTINUE GtT) 
00900 * 

t 

( ESC ^ 



cdskc:myfile»ctl3 



When 
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s the COMPILE command to the system to 
If an error does not occur, the .IF 
command are executed, Batch skips to 

a comment, and passes commands to the 
program MYPROG.FOR is executed and the 
n error occurs while compiling MYPROG, 

command and continues reading the 
iled and then executed. Batch is then 
, which is a comment line. The end of 



The examples shown above illustrate only two ways that you can use the 
.IF commands to specify error recovery in the control file. You can 
use any of the Batch commands or any system command that you wish to 
recover from errors in your job. 

However, you do not have to attempt to recover from errors while your 
job is running. You can correct your errors according to the error 
messages in the log file when your job is returned to you, and then 
run your job again. The log file is described in Chapter 4. 
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CHAPTER 3 
ENTERING A BATCH JOB FROM CARDS 



When you enter a job to Batch from card input, you must create a 
control file on cards that is somewhat similar to a control file 
created on a timesharing terminal, but that contains some additional 
Batch commands. The card control file must tell Batch to start your 
job, the tasks or steps your job must take, and when to stop your 
Batch job. The tasks or steps in your Batch job can consist of calls 
to a system program, can create files on disk, and can recover from 
errors. 

Your control card input to Batch may contain any combination of 
commands. These commands are in four groups as follows: 

1. TOPS-10 system commands, which consist of commands in a 
format similar to what you would issue for the same command 
on a timesharing terminal. Examples of these commands are 
.COPY, .DISMOUNT, .PRINT, and .RENAME. 

2. System program commands, which consist of commands that 
pertain to a system or user program. An example is the 
command to the FILCOM program to specify files to be 
compared. 

3. Batch commands, as described in Chapter 2, Section 2.3, 

4. Batch control card commands, some of which are listed below. 

$JOB (See Section 3.2.1) 

$PASSWORD (See Section 3.2.2) 

$EOJ (See Section 

$CREATE (See Section 

$-language (See Section 

$EXECUTE (See Section 

$DATA (See Section 

$EOD (See Section 3.2.8) 

$TOPS10 (See Section 3.2.9) 

$ERROR (See Section 3.2.10) 

$NOERROR (See Section 3.2.10) 

Not all of the available Batch control commands are listed 
above and described in Section 3.2. Refer to the 
DECsystem-10 (TOPS-10) Batch Reference Manual for a complete 
description of all available Batch control card commands. 
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3.1 BATCH CONTROL CARD FORMAT CONVENTIONS 

The Batch control cards must contain a dollar sign ($) in column 1 and 
a command that starts in column 2. The command must be followed by at 
least one space, which can then be followed by other information. 
(Refer to the individual description of each card for more information 
about it . ) 

A card with a TOPS-10 system command must contain a period (.) in 
column 1 followed immediately by the command. Any information that 
follows the command is in the format shown for the command in the 
DECsystem-10 (TOPS-10) Operating System Commands Manual. The $TOPS10 
Batch control card command must precede TOPS-10 system commands in 
your card deck. (Refer to Section 3.2.9 for the format and 
description of the $TOPS10 card.) 

A card with a command to a system program must contain an asterisk (*) 
in column 1 followed immediately by the command string. 

Batch commands are formatted in the same manner as system commands; 
that is, a period (.) is punched in column 1 and the command 
immediately follows it. You must also place a $TOPS10 card before 
Batch commands in the card deck to enable execution of these commands. 

If you put any special characters other than those described above in 
the first column of a card, you may get unexpected results because 
Batch interprets other special characters in special ways. 

If you have more information than will fit on one card, insert a 
hyphen (-) as the last nonspace character on the first card and 
continue the information on the second card. 

Comments can also be included either on separate cards or on cards 
containing other information. If the entire card is to contain a 
comment, the card should contain a dollar sign ($) in column 1 and an 
exclamation point (!) in column 2. The exclamation point (!) is 
called the comment character. If the card contains a command followed 
by a comment, only the exclamation point (!) should precede the 
comment. If the comment is too long to be contained on a single card, 
begin the next card with a dollar sign ($) in column 1 and the 
exclamation point (!) in column 2 and then continue the comment. 
Refer to the manual that describes the program you are using, as some 
programs and their input do not accept comments preceded by the 
exclamation point (!). 



3.2 BATCH CONTROL CARD COMMANDS 

Eleven Batch control card commands are described in the following 
sections. Additional Batch control card commands are available and 
can be referred to in the DECsystem-10 (TOPS-10) Batch Reference 
Manual . 



3.2.1 Starting a Job - The $JOB Card 

The $JOB card is the first card in your card deck. The $JOB card 
tells Batch whose job it is processing and, optionally, the name of 
the job, and any constraints that you want to place on the job. When 
Batch reads the $JOB card, it begins the log file for your job. 
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The $JOB card has the form: 











v^SJOB jobname[proj,prog] 











[pro j, prog] 



/switches 



is the project-programmer number assigned to you 
by the installation to allow you to gain access to 
the DECsystem-10. The project-^programmer number 
(PPN) must be enclosed in either square brackets 
([ ]), parentheses (( )), or angle brackets (< >) . 
Square brackets can be obtained with a C sign for 
the left bracket and a ! sign for the right 
bracket., Refer to Appendix B of the Hardware 
Reference Manual for a description of several 
kinds of keypunches; 

are optional switches to Batch to tell it the 
constraints that you have placed on your job. 
They are described below. 



/AFTER :dd-mmm-yy hhtmm Switch 

If you do not want Batch to run your job until after a certain time 
and/or a certain day, you can include the /AFTER switch on your $JOB 
card. The date and time are specified in the form dd-mmm-yy hh:mm 
(e.g., 16-APR-78 17:15). If you omit this switch, Batch schedules 
your job as it normally does; that is, Batch schedules your job based 
on the time required and other parameters. 

/AFTER: +hh:mm Switch 

If you do not want Batch to run your job until after a certain amount 
of time has elapsed since the job was entered, include this form of 
the /AFTER switch on the $JOB card. The amount of time that the job 
must wait after it has been entered is specified in the form +hh:mm 
(e.g., +1:30). If this switch is not included, Batch will schedule 
the job as it normally does. 



/PAGES :n Switch 



Normally, Batch allows your job to print up to 200 pages. Included in 
this number are the log file and any compilation listings that you may 
request. If you need more than 200 pages for your job, you must 
include the /PAGES switch on the $JOB card to indicate the approximate 
number of pages that your job will print. If your output exceeds 
either the maximum that Batch allows or the number that you specified 
in the /PAGES switch, the excess output will not be printed and the 
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message 7LPTPLE Page Limit Exceeded will be written in the log file. 
However, even if you exceed the maximum, the first 10 pages of the log 
file will be printed. 

NOTE 

Do not arbitrarily enter a large PAGES 
value as this may delay execution of 
your Batch job. 

/TIME:hh:mm:ss Switch 

Normally, Batch allows your job to use up to five minutes of central 
processor (CPU) time. CPU time is the amount of time that your job 
runs in memory, not the amount of time that it takes Batch to process 
your job. If you need more than five minutes of CPU time, you must 
include the /TIME switch on the $JOB card to indicate the approximate 
amount of time that you will need. If you do not specify enough time, 
Batch will terminate your job when the time is up. However, if you 
specify a large amount of time, Batch may hold your job in the queue 
until it can schedule a large amount of time for it. 

The value in the /TIME switch is given in the form hh:mm:ss 
(hoursrminutes : seconds) . If you specify only one number, Batch 
assumes that you mean seconds. Two numbers separated by a colon (:) 
are assumed to mean minutes and seconds. All three numbers separated 
by colons mean hours, minutes, and seconds. For example: 

/TIME: 25 means 25 seconds 

/TIME: 1:25 means 1 minute and 25 seconds 

/TIME: 1: 25: 00 means 1 hour, 25 minutes, and no seconds 

The following rules apply to all switches in the above list that 
require a time and/or date to be specified: 

When you specify the time of day (hh:mm:ss) 

1. You must not omit the colon (:) or colons. 

When you specify a date (dd-mmm-yy) 

1. You must not omit the hyphens. 

2. You must specify both the day and the month as a minimum 
requirement. 

3. You can abbreviate the month to a minimum of three letters, 
e.g . , JUL for July. 

4. If you omit the year, the current year will be used. 

5. If you omit the time from a date specification, the time is 
assumed to be midnight on the specified date. In the example 
below a current date and time of 20 April, 1978, 10AM will 
be assumed. 

/AFTER:18:00 means 6 P.M. on April 20, 1978 

/AFTER: 3-May means midnight on May 3, 1978 
/AFTER:19-Apr 20:00 means 8 P.M on April 19, 1978 
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3.2.2 Identifying Yourself - The $PASSWORD Card 

You put the password that has been assigned to you on the $PASSWORD 
card to tell Batch that you are an authorized user of the system. 

In conjunction with the $JOB card, the $PASSWORD card identifies you 
to Batch and tells Batch to process your job. If you put a password 
on the $PASSWORD card that does not match the password stored in the 
system for you, Batch will terminate your job. The $PASSWORD card 
must be present and must immediately follow the $JOB card. 

The $PASSWORD card has the form: 











./SPASSWORD password 











password is a 1- to 6-character password that is stored in 
the system to identify you. There must be exactly 
one space between the end of the card name 
($PASSWORD) and the first character of your 
password. 



3.2.3 Ending a Job - The $EOJ Card- 

You must put the $EOJ card at the end of the deck containing your 
complete job to tell Batch that it has reached the end of your job. 
If you omit the $EOJ card, an error message will be issued. However, 
your job will still be scheduled and may be processed if another job 
follows it. The form of the $EOJ card is shown below. 











y/SEOl 











3.2.4 Creating a File - The $CREATE Card 

You can put the $CREATE card in front of any program, data, or other 

set of information to make Batch copy the program, data, or 

information into a disk file. If the appropriate switch is included, 
Batch will also print this file on the line printer. 
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The form of the $CREATE card is: 











yS SCREATE filename.ext/switches 











filename .ext 



/switches 



specifies the optional filename and file 
extension you want Batch to put on the file it 
creates for your program or data. If you omit 
the filename and extension, Batch will create a 
unique name for your file of the form CRxxxx, 
where xxxx represents a unique name generated by 
Batch. 

are switches to Batch to tell it how to read the 
cards in your deck. The switches are described 
below. 



/WIDTH :n Switch 



Normally, Batch reads 80 columns on every card in your deck. You can 
make Batch stop reading at a specific column by means of the /WIDTH 
switch, where you indicate the number of the column at which to stop. 
Thus, if you have no information in the last 10 columns of each card 
in your deck, you can tell Batch to read only up to column 70 by 
specifying 

/WIDTH: 70 



/SUPPRESS Switch 



When Batch reads the cards in your deck, it normally copies everything 
on the card up to column 80 (or up to any column you may specify with 
the /WIDTH switch). However, if you do not want trailing spaces 
copied (to save space on the disk, for example) , you can tell Batch, 
by means of the /SUPPRESS switch, not to copy any trailing spaces into 
the disk file. 



/PRINT Switch 



The file currently being created on disk by Batch 
line printer. 



is listed 



on 



the 
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Examples 

The simplest form of the $CREATE card is: 

$CREATE 

This card causes Batch to copy your deck into a disk file and to 
assign a unique name to it. All 80 columns of the cards are read and 
trailing spaces are copied into the file. The file is not printed. 

The following is an example of a $CREATE card. 

$CREATE MYFILE. CDS/WIDTH % 50/PRINT 

The deck that follows this card is copied into a disk file named 
MYFILE. CDS. When Batch reads the cards in the deck, it copies 
trailing spaces into the file, reading up to 50 columns. The disk 
file created from your cards will be printed on the line printer. 



3.2.5 Compiling a Program - The $-language Card 

The $-language card specifies the source program language of your 
program on cards. It is placed in front of your program. The 
$-language card may be any of the following: 

1. $COBOL 

2. $ FORTRAN 

3. $ MACRO 

4. $ALGOL 

The $-language card causes Batch to copy your source program into a 
disk file and compile it. You may then execute your program by using 
the $EXECUTE card (Section 3.,2.6) or the $DATA card (Section 3.2.7). 
Optional information (/switches) may be included on the $-language 
card to tell Batch how to read and compile your program. 

When Batch copies your source program file onto disk, Batch assigns a 
unique filename for your program in the form of LNxxxx. Depending on 
the type of $-language card, the appropriate file extension is also 
assigned to this file. When your Batch job completes, the LNxxxx file 
is deleted automatically. 
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The $-language card has any of the following forms 



SALGOL/switches 



SCOBOL/switches 



SFORTRAN/switches 



SMACRO/switches 



/switches are switches to Batch to tell it how to read your 
program and whether or not to request a 
compilation listing when the program is compiled. 
The switches can be put on the card in any order. 
The following three switches may be used with any 
of the $-language cards. Additional switches are 
available and can be referenced in the 
DECsystem-10 (TOPS-10) Batch Reference Manual. 



/WIDTH :n Switch 



Normally, Batch reads up to 80 columns on every card of the source 
program. You can make Batch stop reading at a specific column by 
means of the /WIDTH switch. You indicate the number of a column at 
which to stop. Thus, if you have no useful information in the last 10 
columns of each card of your program, you can tell Batch to read only 
up to column 70 by specifying 

/WIDTH: 70 



/NOLIST Switch 



Normally, the $-language card tells Batch to ask the compiler to 
generate a compilation listing of your source program. The listing is 
then printed as part of your job's output. If you do not want this 
listing, you can include the /NOLIST switch on the $-language card to 
stop generation of the listing. 
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/SUPPRESS Switch 



When Batch reads the cards of your source program it normally copies 
everything on the card up to column 80 or any column you may specify 
with the /WIDTH switch. However, if you do not want trailing spaces 
copied (to save space on the disk, for example), you can tell Batch, 
by means of the /SUPPRESS switch, not to copy any trailing spaces into 
the disk file. 

Examples 



The simplest form of the $-language card is 
example using ALGOL. 

$ALGOL 



shown in the following 



This card causes Batch to copy your ALGOL card program into a disk 
file. The cards in the program are read up to column 80 and trailing 
spaces are not suppressed. A listing file is produced when the 
program is compiled. The listing is written as part of the job's 
output. 

The following is an example of a $ALGOL card with switches. 

$ALGOL/NOLIST/SUPPRESS/WIDTH : 72 

With this card, Batch copies your program onto disk and inserts a 
COMPILE command into the control file. When the program is compiled, 
no listing is produced. The cards in the program are read up to 
column 72, and trailing spaces up to column 72 are not copied into the 
file. 



3.2.6 Executing a Program - The $EXECUTE Card 

The $EXECUTE card is used to execute the program that has been 
compiled using the $-language card. This card is used when the 
program requires no data or uses data already existing on disk. The 
form of the $EXECUTE card is shown below. 











yS SEXECUTE/switch 











/switch is a switch to Batch to tell it what to include 
the command it inserts in the control file. 



in 
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/MAP Switch 



If you want a loader map to be generated and printed for you when your 
program is run, you can specify the /MAP switch on the $EXECUTE card 
to tell Batch to request one for you. 

An $EXECUTE card following another $EXECUTE card in the control file 
without any intervening $-language cards causes the program executed 
by the first EXECUTE card to be loaded and executed again. 



3.2.7 Executing a Program with Data - The $DATA Card 

The $DATA card is used when you want to execute a program that uses 
data from cards. The $DATA card must be in front of the input data 
cards. When Batch reads the $DATA card, Batch copies the data cards 
that follow it onto a spooled card-reader file and then inserts an 
EXECUTE command into your control file to execute your program. 

When your job is run, any programs are executed which were entered 
with $-language cards that came before the $DATA card. The spooled 
card reader file becomes the input to the currently executing program, 
and your program may reference this file by using the card reader as 
the input device. 

If your input control file contains more than one program and input 
data, Batch will execute the first program with the input data, spool 
the results to be printed, and then compile the second program when 
Batch reads the second $-language card. Again, when Batch reads the 
second $DATA card, a spooled card-reader file is created for your 
input data cards and an EXECUTE command is inserted in your control 
file. 

A $DATA card (with its associated card deck) followed by another $DATA 
card (with its deck), without intervening $-language cards, causes the 
program to be loaded and executed twice. The first deck is used as 
data on the first execution and the second deck is used as data on the 
second execution. 

If your data is included in the program or is already on disk (so that 
you do not have cards with data on them) , use the $EXECUTE card 
(Section 3.2.6) to execute the program. 

The form of the $DATA card is: 











yS $DATA filename.ext/switches 
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filename. ext specifies an optional filename and file 
extension for the input data file (see Section 
3.2.7.1). If omitted, a spooled card-reader 
file is created. You may reference this file by 
using the card reader as the input device in the 
source program. If included, a disk file is 
created, and you may reference this file by 
using the disk as the input device. 

/switches are switches to Batch to tell it how to read 
your data cards. The switches are described 
below. 

/WIDTH :n Switch 

Normally, Batch reads up to 80 columns on every card of your data. 
You can make Batch stop reading at a specific column by means of the 
/WIDTH switch, where you indicate the number of a column at which to 
stop. Thus, if you have no useful information in the last 10 columns 
of each card of your data, you can tell Batch to read only up to 
column 70 by specifying 

/WIDTH: 70 

/SUPPRESS Switch 

When Batch reads the cards of your data, it normally copies everything 
on the card up to column 80 or up to any column you may specify with 
the /WIDTH switch. However, if you do not want trailing spaces copied 
(to save space on the disk, for example), you can tell Batch, by means 
of the /SUPPRESS switch, not to copy any trailing spaces into the disk 
file. 

/MAP Switch 

If you want a loader map to be generated and printed for you when your 
program is run, you can specify the /MAP switch on the $DATA card to 
tell Batch to request one for you. 

Examples 

The simplest form of the $DATA card is: 

$DATA 

This card causes Batch to copy your data into a spooled card-reader 
file. A spooled card-reader file is a file that Batch creates on disk 
so that, when your program reads from the card reader, that file is 
read. All 80 columns of the cards are read and trailing spaces are 
copied into the file. 

The following example shows a $DATA card with switches. 

$DATA MYDAT. DAT/WIDTH: 72 
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The data that follows this card is copied into a file named MYDAT.DAT 
and an EXECUTE command is inserted into the control file. When Batch 
reads the cards of the data, it reads only up to column 72 and copies 
trailing spaces into the data file. To use the data in this file, 
your program should reference file MYDAT.DAT on the disk. 



3.2.7.1 Reading from a Spooled Card-Reader File - If you let Batch 
assign a name to your data file, you will not know the name that your 
data file will have; you should, therefore, assign your data file, 
without a name, to the card reader. The following examples illustrate 
how to do this. 



NOTE 

The $DATA card can be used for data of 
programs written in ALGOL, COBOL, 
FORTRAN, and MACRO. It can also be used 
for programs that are in relocatable 
binary form. However, data for BASIC 
programs cannot be copied by means of 
the $DATA card because BASIC programs 
are not compiled and executed. For 
BASIC programs, use the $CREATE card as 
described in Section 3.2.4. 



COBOL Example 



ENVIRONMENT DIVISION. 
INPUT-OUTPUT SECTION. 
SELECT SALES, ASSIGN TO CDR. 



DATA DIVISION. 

FILE SECTION. 

FD SALES, LABEL RECORDS ARE OMITTED, 



$DATA (in the control file) 
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FORTRAN Example 



To read your data from the card reader, you use the unit number 
no unit number, as shown below. 



or 



$ FORTRAN 



READ (2 



END 
$DATA 



$ FORTRAN 



READ f, 



END 
$DATA 



f), list 



list 
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ALGOL Example 

In an ALGOL program, you assign the desired channel (signified by c) 
to the card reader and select the desired channel. Do not explicitly 
open the named file on the channel because the file does not have a 
name that is known to you. 



INPUT (c, "CDR" ) 
SELECT INPUT (c) 



$DATA 



3.2.7.2 Naming Data Files on the $DATA Card - If you want to name 
your data file on the $DATA card rather than letting Batch name it for 
you, you must, in your program, assign that file to disk as shown in 
the following examples. 

COBOL Example 



ENVIRONMENT DIVISION. 
INPUT-OUTPUT SECTION. 
SELECT SALES, ASSIGN TO DSK . 



DATA DIVISION. 

FILE SECTION. 

FD SALES, VALUE OF IDENTIFICATION IS "SALES CDS". 



The $DATA card would then appear as follows 
$DATA SALES. CDS 
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FORTRAN Examples 



You can assign your data to disk in several ways when you use FORTRAN. 
You can read from unit 1, which is the disk, in your program and use 
the name FOR01.DAT as the filename on your $DATA card, as shown in the 
following statements. 



READ (1 



f ) , list 



$DATA FOR01.DAT 

You can also tell FORTRAN to read from logical unit 2, which is 
normally the card reader, and assign unit 2 or the card reader (CDR) 
to disk (DSK) . You can use the name FOR02.DAT on the $DATA card in 
this case. 



OPEN (UNIT=2,DEVICE» , DSK') 
READ (2,f) , list 



$TOPS10 

.ASSIGN DSK CDR 

$DATA FOR02.DAT 



ALGOL Example 



To read your data from the disk in an ALGOL program, you would use the 
following statements. You can assign your data to any channel 
(signified by c) and you can give your data file any name as long as 
the name that you use in your program is the same as that put on the 
$DATA card. 
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INPUT (c, "DSK") 
SELECT INPUT (c) 
OPENFILE (C, "MYDAT.DAT") 



$DATA MYDAT.DAT 

This is done to ensure that your program finds your data in the disk 
file under the name that you have assigned to it. 



3.2.8 End of Data Input - The $EOD Card 

The $EOD card terminates the card input that was preceded by a 
$CREATE, $DATA, or $-language card. 

The form of the $EOD card is: 











/ seod 











If the $EOD card does not follow the card input, Batch recognizes the 
next card with a dollar sign ($) in column one as a new Batch command 
and as the end of the card input; that is, an EOD card is assumed if 
one is not present. 



3.2.9 System Commands - The $TOPS10 Card 

You can include system commands, commands to system or user programs, 
and Batch commands in your deck by inserting a $TOPS10 card 
immediately before these commands. The $TOPS10 card directs Batch to 
copy all cards following it into the Batch control file. Therefore, a 
single system command or Batch command or a group of consecutive 
system and/or Batch commands must be preceded by a $TOPS10 card. The 
copying process is terminated by the next control card in the deck. 
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The form of the $TOPS10 card is: 











yS ST0PS1 0/switches 











/switches are switches to Batch to tell it how to 
interpret your input. 



read and 



/WIDTH :n Switch 



Normally, Batch reads up to 80 columns on every card of your system or 
Batch commands. You can make Batch stop reading at a specific column 
by using the /WIDTH switch, where you indicate the column number at 
which Batch is to stop reading. Thus, if you have no useful 
information in the last 10 columns of each card, you can tell Batch to 
read only up to column 70 by specifying 

/WIDTH: 70 



/SUPPRESS Switch 



When Batch reads your cards, it normally copies everything on the card 
up to column 80 or up to any column you may specify with the /WIDTH 
switch. However, if you do not want trailing spaces copied (to save 
space on the disk, for example), you can tell Batch, by means of the 
/SUPPRESS switch, not to copy any trailing spaces into the disk file. 



Figure 3-1 illustrates a sample 
TOPS-10 commands. 



Batch input card deck using only 
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.SYSTAT 



.RESOURCES 



QUEUE 




$EOJ 



.DIRECT 



.INITIA 



NODE 



DAYTIME 



STOPS 10 



SPASSWORD password 



$JOB [proj,prog] 



Figure 3-1 Batch Card Deck Using TOPS-10 Commands 



3.2.10 Error Recovery - The $ERROR and $NOERROR Cards 



You can use the $ERROR card and the $NOERROR card to 
errors that may occur while your Batch job is running 
occurs during your job (for example, a program fails 
Batch will normally terminate your job. 
$NOERROR card is included in your card deck 



recover from 
If an error 

to compile) , 
However, if a $ERROR or 
immediately after the 



point at which the error occurs, Batch will proceed as indicated on 
the $ERROR or $NOERROR card and will not terminate the job. 
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The $ERROR card has the form: 











>^$ERROR statement 











The $NOERROR card has the form: 











>/'$NOERROR statement 











statement is a system command or a special Batch command 
(for example, .GOTO or .BACKTO) such as you would 
include following a $TOPS10 card. The Batch 
commands are described in Section 2.3. The 
statement may also be a comment (begun with the 
exclamation point (!) ) if you wish Batch to simply 
ignore the error. 

If an error occurs in your Batch job and the $ERROR card is then 
encountered, the statement on the $ERROR card is executed and the job 
continues. If the $ERROR card is encountered when an error has not 
occurred, the card is ignored. 

If an error occurs in your Batch job and the $NOERROR card is 
encountered, no action will be taken, with the exception that Batch 
will not terminate your job as it would have if the card had not been 
found. If the $NOERROR card is encountered when no error has 
occurred, the statement on the $NOERROR card is executed. 

The $ERROR card is equivalent to the Batch command .IF (ERROR). The 
$NOERROR card is equivalent to the Batch command . IF (NOERROR) . See 
Section 3.5 for examples of Batch jobs using the $ERROR and $NOERROR 
cards. 
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3.3 SETTING UP YOUR CARD DECK 

Batch enters commands into the control file when you use certain 
control cards. Where you put these control cards in your card deck 
determines their position in the control file. Batch reads your card 
deck in sequential order, copying commands into the control file as 
they or the special control cards are read. However, when Batch reads 
a control card that tells it to copy a program or data into a disk 
file, the disk file is created immediately, before the remainder of 
the job is processed. Every succeeding card is copied until another 
control card is read. 

A Batch job can do almost anything a timesharing job can do. If you 
wish to perform complicated tasks, you may include system commands in 
your deck to direct Batch to execute these tasks. Section 3.4 
describes the way to include system commands for the desired control. 

The $JOB card, the $PASSWORD card, and the $EOJ card are required for 

all jobs. The $JOB card must be the first card in the deck and must 

be immediately followed by the $PASSWORD card. The $EOJ card must be 
the last card in the deck. 

The control cards used to compile and execute programs written in 
ALGOL, COBOL, FORTRAN, and MACRO are shown in Figure 3-2. The 
following card deck does not apply to control card decks for BASIC. 
Refer to Section 3.4.1 for information regarding BASIC. 




NOTE: 
For other languages use 
SCOBOL, 
SFQRTRAN, 
SMACRO, etc. 



Figure 3-2 Typical Program Card Deck 
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The typical card deck shown in Figure 
($ALGOL, $COBOL, etc.) immediately p 
language card informs Batch of the sy 
processing (compiling) the succeedin 
immediately precedes the data car 
succeeding cards contain data for th 
on disk as a disk file. The input 
card-reader file. The $DATA card cau 
using the data cards as input. The $ 
cards pertaining to the job have been 
access to the program to be compiled 
program; it knows what compiler or 
built a control file containing the 
program will be run. 



3-2 includes a language card 
rior to the source program. This 
stem program to be employed for 
g cards. The $DATA card likewise 
ds to inform Batch that the 
e program. The program is stored 

data is stored on a spooled 
ses Batch to execute the program, 
EOJ card informs Batch that all 

entered. At this time Batch has 
and the data to be used by the 

assembler is to be used, and has 
EXECUTE command so that the 



3.4 PUTTING COMMANDS INTO THE CONTROL FILE FROM CARDS 



Batch enters commands into the control 
control cards such as $EXECUTE and 
number of operations, such as compilatio 
can be put into the control file us 
operations in your control file other th 
you must include commands in your ca 
your control file. If you want to inclu 
commands in your card deck, you must ins 
before these commands in your deck. The 
copy all succeeding commands into t 
control card is encountered. The comman 
Batch in the same order that they appear 



file when you 

$DATA. However, 
n and execution 
ing control cards 
an compilation o 
rd deck for Batch 
de Batch command 
ert a $TOPS10 car 

$TOPS10 card dir 
he control file u 
ds will later be 

in your card dec 



use certain 

only a small 

of programs, 

To perform 

r execution, 

to copy into 
s or system 
d immediately 
ects Batch to 
ntil the next 

executed by 
k. 



For example, in order to compare two card decks and produce a list of 
the differences, you could include the cards shown in Figure 3-3 in 
your deck. 
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R FILCOM 



$TOPS10/switches 



second card deck 




$EOJ 



LPT:=FILE.ONE,FILE.TWO 



$CREATE FILE.TWO 



$PASSWORD password 




Figure 3-3 Use of Control Cards to Compare Two Card Decks 

The only system commands that you cannot use in a Batch job are ATTACH 
and SET TIME. Batch will send these commands to the monitor, the 
monitor will give an error, and Batch will detect the error and 
terminate your job. Also, you should not use the LOGIN command in 
your Batch job because you will get an error. Batch logs in your job 
in accordance with your $JOB and $PASSWORD cards. 
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3.4.1 Card Decks for Programs that Do Not Have Special Control Cards 

By using system commands and the $CREATE control card, you can process 
any program that does not have special control cards. You put a 
$CREATE card in front of a program, data, or any other group of cards 
to make Batch copy the cards into a disk file and, if you request, to 
print the file on the line printer. The $CREATE card is described in 
detail in Section 3.2.4. You put the $TOPS10 card in front of monitor 
and Batch commands to cause Batch to copy these commands into the 
control file. The $TOPS10 card is described in detail in Section 
3.2.9. 

For example, a BASIC program does not have a specific control card. 
To run a BASIC program under Batch from cards, you can_combine the 
$CREATE card and the $TOPS10 card with system commands. You can also 
use a $CREATE card to copy the data which a BASIC program will use. 
The $DATA card cannot be used, because the $DATA card puts an EXECUTE 
command into the control file, and BASIC does not use the EXECUTE 
command to run. The $TOPS10 card causes Batch to copy the monitor 
commands into the control file. 

Figure 3-4 shows a card deck that enters a BASIC program for running 
under Batch. 
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Figure 3-4 BASIC Program Card Deck with Integral Data 



This BASIC program contains statements that read data from disk file 
FILE. ONE. You answer OLD to the BASIC question 

NEW OR QLD- 

because the program file is on disk and can be retrieved by BASIC. 

If your BASIC program reads data that is to be input from a terminal 
during the running of the program, enter the data in the control file 
so that it will be passed to your program by Batch. This is shown in 
Figure 3-5. 
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3,5,-9,1,8 



5,1,3,2,-7 



1,2,3,2,-7 



*DSK:MYPROG.BAS 




$EOJ 



MONITOR 



BASIC source program 



SCREATE MYPROG.BAS 



$PASSWORD password 



Figure 3-5 BASIC Program Card Deck with Provisions 
for Terminal Data Input 



You can use the same technique to enter programs written in any 
language that does not have a specific control card provided that your 
installation supports the language. Also, you can run system programs 
under Batch using the same technique. 
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3.5 SPECIFYING ERROR RECOVERY IN THE CONTROL FILE 



Normally, when an error occurs in 
However, you can specify recove 
means of the $ERROR and $NOERROR 
You must include one of these c 
where an error may occur. When a 
next system command level line ( 
or command strings of a system 
statement or .IF(NOERROR) stat 
error. If an error does not occu 
present, the .IF (ERROR) statemen 
an .IF(NOERROR) statement is pres 
the exception that Batch does not 



your job, Batch terminates the job. 
ry from errors in the control file by 
cards, described in Section 3.2.10. 
ards at the point in the control file 
n error occurs, Batch examines the 
skipping over lines that contain data 

program) to find an .IF (ERROR) 
ement to tell it what to do about the 
r and an .IF (ERROR) statement is 
t is ignored. If an error occurs and 
ent, the statement is ignored with 

terminate the job. 



Thus, if you have a program that you are not sure is error free, you 
can include a $ERROR or $NOERROR card to tell Batch what to do if an 
error occurs, as shown in Figure 3-6. 



$ERROR statement 




$EOJ 



REMAINDER OF JOB 



FORTRAN source program 



$PASSWORD password 



Fiqure 3-6 Card Deck with Error Statement 
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The above cards would cause Batch to make the following entries in the 
control file. 

.COMPIL . 

.IF (ERROR) statement 

On either the $ERROR or $NOERROR card, you must include a statement 
that tells Batch what to do. You can use any system command, a 
command to a program, or one of the special Batch commands. The .GOTO 
and .BACKTO Batch commands are commonly used for this purpose. Refer 
to Sections 2.3.4 and 2.3.5 for descriptions of these commands. If 
you use .GOTO or .BACKTO on your $ERROR or $NOERROR card, be sure that 
you supply a line for the control file that has the label you 
specified in the .GOTO or .BACKTO command. 

Two sample jobs are shown on the following pages. The first shows the 
use of the $ERROR card and the .GOTO command to specify error 
recovery. The second example shows the use of the $NOERROR card and 
the .GOTO command. 

If you have a program that may compile with errors, you can include 
another version of the same program in your job (that hopefully will 
compile) and tell Batch to compile the second program if the first has 
an error. The cards to enter this job are shown in Figure 3-7. 
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STOPS 10 



SEXECUTE 



FORTRAN source program 



SERROR .GOTO A 





$EOJ 



B::!CONTINUE 



SFORTRAN 



A::!CONTINUE 



.GOTO B 



STOPS 10 



SEOD 



data for program 



SDATA FOR0.1. DAT/MAP 



FORTRAN source program 



Figure 3-7 Card Deck with Error Recovery Program 
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These cards set up the following control file for you. 

.COMPIL /COMP/F10 DSK:LNxxxx. FOR/LIST 

.IF (ERROR) .GOTO A 

.EXECUT /REL/MAP:LPT:MAP DSK : LNxxxx . REL 

.GOTO B 

A: : 

ICONTINUE 

.COMPIL /COMP/F10 DSKtLNxxxx. FOR/LIST 

.EXECUT DSK: LNxxxx. REL 

B: : 

ICONTINUE 

.DELETE DSK: LNxxxx. FOR, DSK: LNxxxx. REL, DSK: LNxxxx. FOR, DSK: LNxxxx. REL 

The $FORTRAN card told Batch to copy the program into a disk file, to 
create a unique filename for the program in the form LNxxxx. FOR, and 
to insert a COMPILE command into the control file. The $ERROR card 
told Batch to insert .IF (ERROR) .GOTO A into the control file. The 
data was copied into a disk file and an EXECUTE command was put into 
the control file because of the $DATA card. The $TOPS10 card told 
Batch to start copying cards into the control file, so Batch put the 
next two lines into the control file. The second $FORTRAN card told 
Batch to copy the program into a disk file, create another unique 
filename for the program in the form LNxxxx. FOR, and put a COMPILE 
command into the control file. A $EXECUTE card was used instead of a 
$DATA card because the data for the second program was already in a 
file on disk. The $TOPS10 card caused the next line to be put into 
the control file. 

When the job is started, Batch reads the control file and passes 
commands to the system. If an error occurs in the compilation of the 
first program, Batch executes the .GOTO command within the .IF 
statement. The command tells Batch to skip to the line labeled A, 
which contains a comment. Batch then proceeds to the next line. The 
second program is compiled and executed with the data. The next line 
is a comment, so Batch continues to the end of the control file. If 
an error does not occur in the first program, Batch skips the .IF 
statement, executes the program with the data, avoids the second 
program by skipping to label B, and continues to the end of the 
control file. 

A variation of the above procedure, using the $NOERROR card and .GOTO 
command is shown in Figure 3-8. The difference is that Batch skips 
the .IF statement if an error occurs and performs it if an error does 
not occur. 
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EXECUTE 



A::!CONTINUE 



GOTO B 



EXECUTE 



STOPS 10/switches 



$EOD 



data for program 




$EOJ 



B::!CONTINUE 



$CREATEFOR0.1.DAT 



FORTRAN source program 



SFORTRAN 



SNOERROR .GOTO A 



FORTRAN source program 



SFORTRAN 



$PASSWORD password 



$JOB [proj,prog] 



Figure 3-8 Card Deck Using GOTO Statement 
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Batch reads the cards and puts the following commands into the control 
file. 

.COMPIL /COMP/F10 DSK:LNxxxx. FOR/LIST 

.IF(NOERROR) .GOTO A 

.COMPIL /COMP/F10 DSK:LNxxxx. FOR/LIST 

.EXECUT DSK:LNxxxx.REL 

.GOTO B 

A: : 

ICONTINUE 

.EXECUT DSK:LNxxxx.REL 

B: : 

i CONTINUE 

.DELETE DSK:LNxxxx.FOR,DSK:LNxxxx.REL,DSK:LNxxxx.FOR,DSK:LNxxxx.REL 

The $FORTRAN card tells Batch to copy the FORTRAN program into a file, 
to create a unique filename of the form LNxxxx.FOR, and to insert a 
COMPILE command into the control file. The $NOERROR card tells Batch 
to insert an .IF command into the control file. 

The second $FORTRAN card tells Batch to copy the second program into a 
disk file, to create a unique filename of the form LNxxxx.FOR, and to 
insert another COMPILE command into the control file. Instead of a 
$DATA card, a $CREATE card is used to tell Batch to copy the data into 
a disk file named FOR01.DAT. The $DATA card is not used here because 
it would have the names of both programs in its list for the EXECUTE 
command generation, which would cause an error when the job is run. 
To tell Batch to start copying cards into the control file, the 
$TOPS10 card comes next. Thus, Batch copies the next five cards into 
the control file. 

When the job is run, Batch passes the COMPILE command to the system to 
compile the first program. If an error does not occur, the .IF 
command is read and the .GOTO command is executed. Batch skips to the 
line labeled A, which is a comment, and continues reading the control 
file. The program LNxxxx.FOR is executed with the data, and the end 
of the job is reached. If an error occurs while compiling the first 
program, Batch skips the .IF statement and continues reading the 
control file. The second program is compiled and then executed with 
the data. Batch is then told to go to the line labeled B, which is a 
comment line. The end of the job follows. The TOPS-10 .EXECUTE 
command was used in this job rather than the $EXECUTE card. The 
$EXECUTE card would have caused the names of both programs to be 
included in the .EXECUTE command which would have resulted in an error 
when the job was run. 

The examples shown above illustrate only two ways that you can specify 
error recovery in the control file. You can use the .BACKTO command 
or any system command that you choose to help you recover from errors 
in your job. 

However, you do not have to attempt to recover from errors while your 

job is running. You can correct your errors according to the error 

messages in the log file when your job is returned to you, and then 
run your job again. 
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INTERPRETING YOUR PRINTED OUTPUT 

You can receive three kinds of printed output from your Batch jobs: 

1. Output that you request, i.e., the results of your job. 

2. Output from Batch commands, i.e., the log file. 

3. Output that is the result of actions by your job, Batch, the 
system, or system programs. Examples of this output are 
compilation listings, cross-reference listings, and error 
messages . 

4.1 OUTPUT FROM YOUR JOB 

If your job uses the PRINT command to print files on the line printer, 
the files will be printed in listings separate from the log file. The 
printed output from each program will be preceded by two banner pages 
containing your user name and other pertinent information. Following 
these pages are two header pages that contain the name of your output 
file in block letters; the output follows these header pages. Two 
trailer pages follow your output; they contain the same information 
that is on the first two pages. The header and trailer pages also 
include three rows of numbers (read vertically from 001 to 132) that 
represent the character print positions on the line printer. 

If your output is usually directed to the terminal, it will be printed 
in the log file, not as a separate file. In the sample output shown 
in Section 4.4, the output from the program is included in the log 
file because it was directed to the terminal rather than the line 
printer . 

Although this chapter deals mainly with printed output, you can have 
output to any device that the installation supports, as long as the 
installation allows you to use these devices. 



4.2 BATCH OUTPUT 

The output from Batch consists of a log file that contains all the 
statements in the control file, commands sent to the system from Batch 
for you, and the replies to the commands from the system and from 
system programs like the compilers. Any error message sent from the 
system or system program or from Batch itself is also written in the 
log file. 
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When your Batch card job is printed on the line printer, it will have 
a unique filename of JBxxxx and a file type of .LOG. This file is 
deleted automatically after it has printed. 



4.3 OTHER PRINTED OUTPUT 

Other output that you can get as a result of action by your job 
includes compiler listings, cross-reference listings, and loader maps 
for programs that were successfully loaded. 

The compiler and cross-reference listings are those listings generated 
by the compiler if you request them. When you enter your job from 
cards, Batch requests compilation listing for you unless you specify 
otherwise. Cross-reference listings are generated for you only if you 
specifically ask Batch for them. When you enter your job from a 
terminal, you must request the listings in the COMPILE command. Refer 
to the DECsystem-10 (TOPS-10) Batch Reference Manual for the switches 
(/CREF, /MAP) that are available to generate additional listings for 
your Batch job. 

If a fatal error occurs in a program in your job and you have not 

included an error recovery command to Batch, Batch will not try to 

recover from the error for you. Instead, it will write the error 
message in the log file and terminate your job. 



4.4 SAMPLE BATCH OUTPUT 

Two sample jobs and their output are shown in the following sections. 
The first shows a job entered from a terminal, the second shows a job 
entered from cards. The log file is somewhat different for the two 
types of jobs. 



4.4.1 Sample Output of a Job from a Terminal 

The following example illustrates a job as it would be entered from a 
terminal. You would first create the program as a file on disk. 

CD 
♦ sos coboli.cblQE) 

Input: C0B0L1.CBL 

00100 IDENTIFICATION DIVISION .C^~) 
00200 PROGRAM- ID* C0BQL1 *C^~) 
00300 ENVIRONMENT DIVISION »O^Q 
00400 DATA DIVISION .CUD 
00500 PROCEDURE DIVISION .CUD 
00600 START. (ED 

00700 DISPLAY "THIS IS TO SHOW SAMPLE OUTPUT FROM BATCH. m >GID 
00800 DISPLAY "THESE TWO LINES ARE OUTPUT FROM THE PROGRAM. " <™T) 
00900 STOP RUN .G»D 
01000 * 
t 

C ESC 3 

*eC™D 

CDSKCJCOBOLl.CBLH 
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Then you would make up a control file to compile and execute the COBOL 
program. 

I , s 

♦ SOS MYJQB»CTLG<<lD 
Input: MYJOB.CTL 

ooioo ♦compile: coboli.cbl/listGiD 

00200 ♦EXECUTE COBOL! ♦ CBL.GED 

00300 * 

t 

( ESC ~) 

cdskc:myjob»ctljj 



You would then submit the job to Batch using the SUBMIT command. 



♦SUBMIT MYJOB.CTLChD 

C INP26 : MY JOB^/Sea : 4951/Time J 1 05 1 003 



When the job is run, the program is compiled and a listing is 
produced. The following listing is placed in the queue of the 
line-printer spooler: 



PRO 


G R A 


C0B0L1 


,C*L 


0001 


00100 


0002 


00200 


0003 


00300 


0004 


00400 


0005 


00500 


0006 


00600 


0007 


00700 


0009 


00800 


0009 


00900 



C U B L 1 
05*APR»78 14|52 



C0B0L-68 121526) BIS 



5-APR-78 14142 



IDENTIFICATION DIVISION, 

PROGRAMED, MYPR0G, 

ENVIRONMENT DIVISION, 

DATA DIVISION, 

PROCEDURE DIVISION, 

STApT, 

DISPLAY "THIS IS TO SHOW SAMPLE OUTPUT FROM BATCH,", 

DISPLAY "THESE TWO LI^Cs ARE OUTPUT FROM THE PROGRAM," , 

STOP RUN, 

NO ERRORS DETECTED 

The log file below is printed as your job's output. The output from 
the program is written in the log file because it is output to the 
terminal and the log file simulates the terminal dialogue. The log 
file also contains some commands that Batch sent to the system for you 
and some additional system information. An annotated log file is 
shown on the following page. Note that each line in the log file is 
preceded by the time of day when the line was written. Following the 
time is a word that describes what kind of information is on each 
line. Much of the information is system information and is described 
in detail in the DECsystem-10 (TOPS-10) Batch Reference Manual. 
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19142 
'5142 
15M2 
15142 



15142 
151*2 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15M2 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 
15142 



29 BAJOB 

29 8AFII 

29 BAFIl 

29 BASUM 



29 MON-TR 

29 MONTR 

30 USEP 
35 'J SEP 

35 USER 

36 MONTP 
36 MONTP 
38 USEP 
50 MONTR 
50 MONTP 
50 MONTP 
50 MQNTP 

50 USER 

51 USER 
51 USER 
51 USEP 
51 MONTR 
51 MQNTP 
51 MONTR 

51 MQNTP 

52 USEP 
52 USER 
54 MONTR 
54 MONTR 
54 MONTR 
54 MONTR 



BATCoN vtrilon 103(2207) running MyjOB stqutncc 495I In »tream 1 
Input from t>SKC|MYJOB,CTL [27,5107] 
OUtPut to DSKClMYJ0B f loG[27,51O7] 
Job parameters 

Tlm«|O0|05|O0 UniquejVES R«tt«rtlNO OUtpUtlLOG 

, LOGIN 27/5107 /DEFER /SPOOL I ALL/TlMEt 300/LUCATEl 26 /NAME » "BKOWN ,E" 
JOB 23 RK3A7A KL10 SYS*1026 TTY5IO 
[LGNjSP Otner jobi same PPN146J 
1542 0i«Aug»7fl Tu« 

, , COMPILE COBOLl.CBL/LIST 
COBOM COBOL1 [COBULl , CBL] 

EXIT 

,, EXECUTE COBOLl.CBL 

LINKf Loading 

[LNKxCT COBOL1 Execution! 

THIS IS TO SHOW SAMPLE OUTPUT FROM BATCH, 

THESE TWO LINES ARE OUTPUT FROM THE PROGRAM, 

EXIT 

.KJOb/BATCH 

[LGTaJL Another job if still logged»in under C27 , 5 1 07 J J 

job 23 user brown, e 127,51073 

Logg e d«of* TTY510 at 1 5 1 42 1 54 o n l«Aug-78 

Puntimel OiOOioi, KCSI22, Connect timet 0100124 

Dlstc Pead»i954, wrl^eii92 



4.4.2 Sample Output of a Job on Cards 

This example shows a job in which a small COBOL program 
and executed. The card deck is shown in Figure 4-1. 



is compiled 




$EOJ 



$EXECUTE 



COBOL source program 



$COBOL 



$PASSWORD password 



$JOB [27,5107] 



Figure 4-1 COBOL Print Program Card Deck 



4-4 



INTERPRETING YOUR PRINTED OUTPUT 



The COBOL program is as follows. 

IDENTIFICATION DIVISION. 

PROGRAM-ID. COBOL1. 

ENVIRONMENT DIVISION. 

DATA DIVISION. 

PROCEDURE DIVISION. 

START. 

DISPLAY "THIS IS TO SHOW SAMPLE OUTPUT FROM BATCH.". 

DISPLAY "THESE TWO LINES ARE OUTPUT FROM THE PROGRAM.". 

STOP RUN. 

When the job is run, the program is compiled and a compilation listing 
is produced. The listing is shown below. Note that the compiler puts 
sequence numbers on the program even though they were not in the 
original program. 



PROGRAM C B L 1 
LN0N3J.CBL 0t.APR.78 07l0l 



C0B0L»6t 12(526) BIS 



7-APR-78 07IU1 



0001 IDENTIFICATION DIVISION,, 

0002 PROGRAMED, COBOL!, 

0003 ENVIRONMfNT DIVISION, 

0004 DATA DIVISION, 

0005 PROCEDURE DIVISION, 

0006 START, 

0007 DISPLAY "THIS IS TO SHOW SAMPLE OUTPUT rRON BATCH,", 

0008 DISPLAY "THESE TWO LINES ARE OUTPUT FROM THE PROGRAM, » , 

0009 STOP HUN, 

NO ERRORS DETECTED 



After the program is compiled, 
in this example does not have 
output is written to a termina 
terminal output is written i 
because the end of the job is 
dialogue between your job and 
commands that Batch sent to th 
is shown on the following pag 
is preceded by the time of day 
the time is a word that descr 
line. Refer to the DECsystem- 
a description and definition o 



it is loaded a 
output to the 1 
1. Because thi 
n the log file, 
reached. The 1 
the system and 
e system for yo 
es. Note that 

when the line 
ibes what kind 
10 (TOPS-10) Ba 
f these words. 



nd executed. The program 
ine printer. Instead its 
s is a Batch job, the 
The log file is printed 
og file contains all the 
system programs, and some 
u. An annotated log file 
each line in the log file 
was written. Following 
of information is on each 
tch Reference Manual for 



13t39|12 STDAT 

13l39|12 STCRD 

1 3 1 39 1 1 2 STCRD 

13I39U4 STMSG 

13|39|14 STCRD 

13I39U4 STCRD 

13I39U4 STSUM 

13I39H4 STSUM 

13139114 STSUM 



2*AUG»78 RK3A7A KL10 SYSI1026 SPRINT Vtriion 102(2024) 

•JOB [27#S107] 

•COBOL 

Flit DSK|LN0N3J„CBL Cr t *ttd • 9 Card* Rtad - 2 BloeKf Written 

•EXECUTE 

»E0J 

End f job Encounttrtd 

14 Cards Read 

Batch Input Rtquait Crtatad 



4-5 



INTERPRETING YOUR PRINTED OUTPUT 



42 
42 
42 
42 



42 
42 
42 
42 
42 
142 
42 
42 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 

43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 
43 



44 BAJQB 

44 BAriL 

44 BAriL 

44 BA8UM 



44 
44 
45 

46 
46 

47 
47 
49 
00 
00 
00 
00 
01 
03 
03 
03 
03 
03 
03 
03 

03 
03 
03 
04 
04 
04 
04 
04 
04 
04 
04 
05 
05 
05 
05 



MONTR 

MONTR 

USEP 

USER 

USER 

MONTR 

MONTR 

USER 

MONTR 

MONTR 

MONTR 

MONTR 

USER 

USER 

USER 

USER 

MONTR 

MONTR 

MONTR 

MONTR 

BLABL 

MONTR 

USEP 

USER 

USER 

USER 

USER 

MONTR 

MONTR 

USEP 

USER 

MONTR 

MONTR 

MONTR 

MONTR 



batcqn vtrtion 102(2067) running jbon3i stqutnct 1258 in strt«m l 
input from DSKCijBON3I t CTLl27,5107) 
Output to DSKCUBON1I,LOGt27, 51071 

Job ptrtmtttrs 

Tl*t|O0|O5f 00 UnlquttYRS PtSttrtlYES OUtpUt|LOG 

, LOGIN 27/5107 /DErER/SPOOLl ALL/TlMEl 300/LOCATEI 26/NAMEI "BROWN, E" 
JOB 49 RK3A7A KLIO SYS«1026 TTY511 
[LGNjSP otntr jobi i«m« pPM2i 
1342 02-Aug*78 U«d 

,,COmPIL /CUMP/COB DSK|UN0N3J,CBL/LI3T 
CUBOLI COBOL1 [LNON3J.CBLJ 

EXIT 

,,EXECUT /REL DSKILNON3J.REL 

LINK| Lo«<Uno 

[LNKxCT COBOL1 ExtCUtion] 

THIS IS TO SHO* OUTPUT TROM BATCH, 

THESE TWO LINES ARE OUTPUT FROM THE PROGRAM, 

EXIT 



%EPP|| 

%riNn 

.DELETE DSK!LN0N3J,CBL,DSK|LN0N3J,REL 

Flits dtitttdl 

LNON3J.CBL 

02 Blocks frttd 

L"ON3J,REL 

02 BioCkl frttd 

,kjob/batch 

[LGTaJL Anothtr job li still loggtd-in undtr 127,510713 

job 49 UStr BROWN, E [27,5107] 
Logg«d«off TTY5H «t 1 3 1 43 1 05 on 2»Au9-78 
Runtimti OtOOiOi, KC8I26, Conntet ti" 1 *! 0100120 
Disk RttdSl976, WrlttS|9| 
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CHAPTER 5 
EXAMPLES OF COMMON TASKS WITH BATCH 



This chapter shows some sample jobs that are run from a terminal and 
from cards. Section 5.1 illustrates entering jobs from a terminal. 
Section 5.2 shows entering jobs from cards. The examples are the same 
in both cases, the difference is in the way that they are entered. 



5.1 USING THE TERMINAL TO ENTER JOBS 

ALGOL Example 



The first job is a simple ALGOL program that writes output to the 
terminal. Since the job is being entered through Batch, the output is 
written in the log file instead of on an actual terminal. 



SOS MYPROG.ALGQiD 

input: myprqg.alb 

00100 BEGINQtT) 

00200 real x j integer irge) 

00300 x:=i?QlD 

00400 FOR I t= 1 UNTIL 1000 DO X t= X+I »QID 
00500 PRINT (XHC^Q 
00600 ENDQeT) 
00700 $ 
t 

*ECED 
cdskc:myprog,alg3 



The control file for the program is created as follows. 



\ 



.sos myfile.ctluillj 
input: myfile.ctl 

00100 .COMPILE MYPROG.ALG/LISTQil 
00200 .EXECUTE MYPROG ♦ ALGC^T) 
00300 



? 



cdskc:myfile*ctl3 
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To execute this ALGOL program using the Batch control file, issue the 
SUBMIT command. 



♦ SUBMIT MYFILEQiD 

C INP26 : MYFILE=/SEQ : 4805/TIME : 1 05 J 003 

» 

When Batch starts the job, the statements in the control file call the 
ALGOL compiler to compile the program. The TOPS-10 monitor then calls 
the loader to load the program for execution. A listing of the 
program will be printed with the log file shown on the following page. 

DEC5YSTEH 10 ALG0L.60, VERSION 6A(634) 01.AUG-78 12|36|03 
COMMAND STRlNGl MYPRoG,LPT|MyPRor,«MYPROG, ALG 



000004 


Bl 




00100 BEGIN 


START OF 


BLOCK 


1 




000005 






00200 


000005 






00|00 


000015 






00400 


000021 






OO5OO 


000024 




El 


00600 END 



REAL X| INTEGER If 

Xt«il 

TOR II* 1 UNTIL 1000 DO X |« X+l f 

PRINT (X)f 



END BLOCK If C0NT 



NO ERRORS 
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12 


135 


155 


BAJOB 


12 


35 


155 


BAriL 


121 


35 


155 


BAFIL 


12 


35 


55 


BASUM 


12 


35 


155 


MQNTB 


12 


35 


155 


MONTR 


12 


35 


156 


USE* 


12 


36 


100 


USER 


12 


136 


100 


USER 


12 


36 


01 


MONTR 


12 


36 


01 


MOMTR 


121 


36 


03 


USER 


121 


36 


04 


MONTR 


12 


36 


104 


MONTR 


12 


36 


04 


MQNTR 


121 


36 


04 


MONTR 


121 


36 


05 


USER 


121 


36 


06 


USER 


12 


36 


106 


USER 


12 


36 


106 


USER 


121 


36 


06 


USER 


121 


361 


06 


MONTR 


121 


36 


06 


MQNTR 


121 


36 


07 


USER 


121 


36 


07 


USER 


121 


36 


08 


MQNTR 


121 


36 


08 


MONTR 


12 


36 


108 


MONTR 


12 


36 


108 


MONTR 


12 


36 


109 


LPDAT 


121 


36 


09 


LPDAT 


121 


36 


13 


LpMSC 


121 


36 


17 


LPM3G 



BATCON VERSION 103(2207) RUNNING MYFlLE SEQUENCE 4805 IN STREAM 5 

INPUT FROM DSKCIMYFILE.CTL127, 5107J 

OUTPUT TO DSKClMYFILE,LOGl27, 51071 

JOB PARAMETERS 

TIME|00|05lOO UNIQUEiYES PESTART|NO OUTPUTlLOG 

.LOGIN 27/5107 /DEFER/SPOOLl ALL/TIME | 300/LOCATE I 26/NAME I "BKOWNfE" 
JOB 2 6 RK3A7A KMO SYSM026 TTY513 
ILGNjSP OTHER JOBS SAME PPN|46J 
1236 ol»AUG*78 TUE 

,, COMPILE MYPROG, ALG/LIST 
ALGOL! MYPROG 

EXIT 

, , EXECUTE MYPROG, ALG 
LINK, LOADING 
CLNKXCT MYPROG EXECUTION] 
liOolOOOOfc 3 

END OF EXECUTION, 

.KJOB/BATCH 

CLGTaJL ANOTHER JOB IS STILL LQGGED»IN UNDER (27,5107) J 
JOB 26 USER BROWN f E (27,51071 
LOGGED-OFF TTY5U AT 12IJ6I07 ON UAUG-78 
RUNTlMEl 0100101, KC3I12, CONNECT TlMEf 0100111 
DISK READSI646, WRITESI24 

LPTSPL VERSION 103(2421) RK3A7A KL10 SYS#1026 

JOB MYFILE SEQUENCE #4805 ON LPT261 AT l-AUG-78 12136109 
ILPTSTF STARTING FILE DS*C IQPUS26 ,LPT [3 , 3 J ) 
(LPTrPF FINISHED PRINTING FILE D8KC |QPOS26,LPT (3, 3U 
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BASIC Example 



The second example is a BASIC program submitted to Batch. You can 
make up the program file using BASIC and save it on disk. Then make 
up a control file that simulates the dialogue with the BASIC system. 
The program is shown below. 

• R BASICQ^D 



READY 

NEWQjD 

NEW PROGRAM NAME- 



-mybas.basCbi: 



READY 
00100 
00200 
00300 
00400 
00500 
00600 
00700 
00800 
00900 
01000 
01100 
SAVEQiD 



INPUT DQED 

IF D - 2 THEN llOOQiD 

PRINT "X VALUE ' r 'S INE 1 

FOR X=0 TO 3 STEP D( 

IF SIN<X)OM THEN 800 ( 

LET X0=XQlD 

LET h=SIN<X)( 

NEXT XQiD 

PRINT X0>MrD( 

GO TO lOOQlD 

ENDQiD 



t 'RESOLUTION 



READY 
MONITOR! 



The program requests data from the your terminal when it is running. 
You include the data in the control file. For this program, the final 
data item must be 2 to conclude the program. The control file 
follows. 



♦ SOS BASIC. CTLQlL 
Input: BASIC.CTL 



00100 
00200 
00300 
00400 
00500 
00600 
00700 
00800 
00900 



.R basicQll) 

*old dsk:mybas.basGll 

*RUN( 

*.1< 

*.01C*" 

*.ooiGID 

*2QjD 

*M0NIT0RC 

t 




CBASIC.CTL.13 
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The output from the program will be printed as part of the control 
file listing. The command to submit the job to Batch is executed as 
follows. 



♦ SUBMIT BASIC ♦ CTL.GED 

C INP26 : BASIC=/Sea : 4823/Time : : 05 i 003 



12 
12 
12 
12 



12 
12 
12 

12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
t2 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 

12 
12 



40 BAJOB 

40 BAFII 

40 BAFIL 

40 BA5UV 



40 MONTR 

40 M0NTP 

41 USER 
4 3 USER 

43 USER 

44 MONTR 
44 MONTR 

44 USER 

45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 
45 USER 

45 USER 

46 USER 
46 USER 
46 USER 
46 USER 
46 USER 
46 USER 
46 USER 
46 MONTR 
46 M NTP 
46 USER 

46 USEH 

47 MONTR 
47 MO^TP 
47 MONTR 
47 MONTP 

49 LPDAT 

49 LpDAT 



BATCON VERSION 103(2207) RUNNING BASIC SEQUENCE 4823 IN STREAM 1 

INPUT FROM D»KClBASlC,CTlC27 # 5t07J 

OUTPUT TO nSKClBASJC,LOG[27,51073 

JOB PARAMETERS 

TtME|O0|O5l00 UNIOUEIYES RESTARTING 0UTPUT|L0G 

,L0GlN 27/5107 /DEFER/SPOOLl ALL/TIME | 300/LOCATEl 26/NAME I "BROWN, E» 
JOB 30 RK3A7A *L10 SYStl026 TTY504 
tLGNjSP OTHER JOBS SAME PPNI46J 
1248 01-AUG-78 TUE 

,,R BASIC 



READY. FOR HELP TYPE HELp, 

OLD 

OLD FILE NAME-*DSK|M*BAS,BAS 

READy 
RUN 



MYBAs 



M 

X VALUE 
1,6 

7.01 
X VALUE 

1,57 

7,001 
X VALUE 

1,571 

72 



12148 



SINE 
0,999574 

SINE 
1. 

SINE 
1. 



01.AUG-78 



RESOLUTION 
0,1 

RESOLUTION 
0,01 

RESOLUTION 
0,001 



TIME| 0,26 SECS, 

READY 
MONITOR 

.KJOB/BATCH 

[LGTAJL ANOTHER JOB IS STILL LOGGED-IN UNDER C27,3107JJ 

JOB 30 USER BROWN, E (27,5107] 

LOGGED.OKF TTY504 AT 12148147 ON t.AUG-78 

RUNTlMEl OiOOlOOt KCSI9, CONNECT TlM£| 0100106 

DISK PEADSI94, WRITESI6 

LRTSPL VERSION 103(2421) RK3A7A KL10 SyS#1026 

JUW BASIC SEQUENCE #4823 ON LPT261 AT l«AUG»7fl 12|48|49 
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FORTRAN Example 



The third example is a FORTRAN program that prints output on the line 
printer. You want to tell Batch in the control file to delete your 
relocatable binary file if an error occurs when your program is 
executed. If an error does not occur, you want Batch to save your 
relocatable binary file as it normally would. The program is shown 
below. 



♦SOS MYPROG.FORUiLJ 
Input J MYPROG.FOR 



00100 


c 


THIS PROGRAM CALCULATES PRIME NUMBERS .QT 


00200 




DO 10 I =ll»50»2(j«D 


00300 




J=iQiD 


00400 


4 


J=J+2QjD 


00500 




A^jQiD 


00600 




A=I/AQiD 


00700 




L^I/JQED 


00800 




b=a-lC0D 


00900 




IF <B> 5,10>5QiD 


01000 


5 


IF <J*LT,SQRT<FLOAT<I>>) GO TO 4QID 


01100 




PRINT 105>I( ret ) 


01200 


10 


CONTINUEQiD 


01300 


105 


FORMAT <I4> 'IS PRIME* 'X^TT) 


01400 




ENDQiD 


01500 


* 
t 









CDSKCJMYPR0G*F0R3 



You create the control file to compile and execute this program, 
deleting the relocatable binary file if there is an execution error as 
follows. 



♦SOS MYFOR*CTLChD 

Input: MYFOR.CTL 

00100 ♦ COMPILE MYPROG.FORQlD 

00200 ♦ EXECUTE MYPRQG »RELC^O 

00300 ♦ IF (ERROR) ♦ DELETE MYPROG.FORQil 

00400 ENDtt! END OF JOB GuD 

00500 * 

t 

( ESC ) 



cdskc:myfor»ctl3 



You submit this job for execution as follows. 



♦SUBMIT MYFOR.CTLQED 

C INP26 : MYF0R=/Sea : 4834/Time : : 05 : 003 
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The program output is as follows 



U if PRIME, 

13 IS PRIME, 

t7 IS PRIME, 

19 15 PRIME, 

23 IS PRIME, 

29 IS PRIME, 

3i IS PRIME, 

37 IS PRIME, 

41 IS PRIME, 

43 IS PRIME, 

47 IS PRIME, 



The log file produced by the job is as follows. 



3IOH48 BAJOB 

3l0t 148 BAFIL 

3101148 BAFIL 

3101148 BASUM 



3101148 
3I0U48 
3101148 
3101151 
3IOU31 
3IOUS2 
3IOH52 
3i01|53 
3101155 
3I0H55 
3IOH55 
3101156 
3101157 
3101159 
3I0H59 
3101159 
3I0U59 
3101159 
3101159 
3IOU59 
3I0U59 

3101159 
3101159 
3I0U59 
3102101 
3102801 
3102101 
3102801 

3|12|35 
3112135 
3112138 
3112144 



MONTR 

MONTR 

USER 

USER 

USER 

MONTR 

MONTR 

USER 

USER 

MONTR 

MONTR 

USER 

USER 

USER 

USER 

USER 

MONTR 

MONTR 

MONTR 

FALSE 

BLABL 

MONTR 

USER 

USER 

MONTR 

MONTR 

MQNTP 

MONTR 

LPDAT 
LPDAT 
LPMSG 
LPMSC 



BATCON VERSION 103(2207) RUNNING MyFOR SEQUENCE 4834 IN STREAM 1 

INPUT FROM D5KClMYFOR,CTLt27,5107] 

OUTPUT TO DSKC|MYFOR,LOG[27,5107) 

JOB PARAMETERS 

TIMEtOOlOSlOO UNIOUE|YES RESTARTING QUTPUTlLOG 

, LOGIN 27/5107 /DEFER/SPOOL I ALL/TIME | 300/LOCATE I 26/NAME I »BKOWN,E" 
JOB 30 RK3A7A KLlO 5YSH026 TTY504 
[LGNJSP OTHER JOBS SAME pPN|46l 
1301 Ol-^UG-78 TUE 

.♦COMPILE MYPROG.FOR 
FOPTRANi myprog 
MAIN, 

,, EXECUTE MYPROG, REL 

LINK| LOADING 

CLNKXCT MYPROG EXECUTION] 

END OF EXECUTION 

CPU TIME! 0,04 ELAPSED TlMEl 0,65 

EXIT 



,IF (ERROR) .DELETE MYPROG.FOR 

END|| 

IEND OF JOB 

.KJOB/BATCH 

tLGTAJL ANOTHER JOB IS STILL LOGGED-IN UNDER (27#5107JJ 

JOB 30 USER BROWN, E t27,5107J 

L0G6ED»0FF TTY504 AT 13102101 ON 1«AUG«78 

RUNTjMEl OlOOlOO, KCSI11, CONNECT TlMEf 0100112 

DISK READSl302.f WRITESH9 

LPTSpL VERSION 103(2421) RKJA7A KL10 SYSM026 

JOB MYFOR SEQUENCE #4834 ON LPT261 AT 1*AUG*78 13tl2l35 
CLPTSTF STARTING FILE DSKCIQP1826 ,LPT (3# 3]J 
(LPTrPF FINISHED PRINTING FILE D8KC IQP1S26 ,LPT ( 3, 33 J 



COBOL Example 



The fourth example is a COBOL program that writes record output on a 
magnetic tape. To have a tape drive assigned and your magnetic tape 
mounted on it, you must make a request to the operator. Since you do 
not know which drive will be assigned to your job, you must assign it 
in your job with a logical device name. The MOUNT command assigns the 
drive to your job and associates the logical name that you specify 
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with the physical drive assigned. The MOUNT command also informs the 
operator of the name or ID number that identifies the particular tape 
you want mounted. (Your tape should be given to the operator or 
stored at the central site before you submit your job.) You create 
the program as follows. 



I 



00100 
00200 
00300 
00400 
00500 
00600 
00700 
00800 
00900 
01000 
01100 
01200 
01300 
01400 
01500 
01600 
01700 
01800 
01900 
02000 
02100 
02200 
02300 
02400 
02500 
02600 




, SOS MYPROG. CBLQ^iiJ 
Input: MYPROG .CBL 

IDENTIFICATION DIVISION.! 
ENVIRONMENT DIVISION .GET 
INPUT-OUTPUT SECTIONS 
FILE-CONTROL . C^H 

SELECT OUTFIL ASSIGN TPDRIV.GiD 
DATA DIVISIONS 
FILE SECTIONS 
FD OUTFIL LABEL RECORDS ARE STANDARD QE) 

VALUE OF IDENTIFICATION IS 'INFIL DAT'QED 

DATA RECORD IS OUTRECQED 

BLOCK CONTAINS 20 RECORDS ♦( 
01 OUTREC PIC X(80).GlD 
WORKING-STORAGE SECTIONS 
77 A PIC 9999 USAGE IS COMP .( 
PROCEDURE DIVISION .(l^T) 
START. CrTT) 

OPEN OUTPUT OUTFIL. QiD 

MOVE ZEROS TO OUTREC .QTT) 

MOVE 1000 TO A.r^n 



LOOP.' 



WRITE OUTREC .C^D 

SUBTRACT 1 FROM A.Q^O 

IF A IS GREATER THAN ZERO GO TO LOOP .QID 

CLOSE OUTFIL. Q^Q 

STOP RUN.QFT) 






cdskc:myprog.cbl3 



You create the control 
(PR0G1.CBL) as follows. 



file (C0BJ0B) used to run the program 



, SOS COBJOB.CTLQiD 

Input? COBJOB.CTL 

ooioo .mount mta:magi/reelid:scrtch/wenableGlD 

00200 .COMPILE MYPROG .CBL/LISTQJD 
00300 .EXECUTE MYPROG .CBLC^O 
00400 .DISMOUNT MAGi:QE3 

00500 * 



*E 



( E SC ) 



CDSKC J COBJOB.CTL 3 
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You submit the job for execution as follows. 



♦ SUBMIT* COB JOB ♦CTL.CmD 

C INP26 1 COB JOB=VSea : 1072/T ime J : 05 1 001 

♦ 

The log file produced by COBJOB is shown below. 



12 
12 
12 

12 



12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 

12 

12 



25 BAJQB 

25 BAFIL 

25 BAFIL 

25 BASUM 



25 MONTR 

25 MQNTP 
2$ USEP 

26 USEP 
26 USEP 
31 USER 

31 USER 

32 MONTR 
32 MONTR 
34 USER 
34 USER 
01 USER 
01 MnNTR 
01 MONTR 
01 USEP 
08 MONTR 
08 MQNTR 
08 MONTR 
08 MQNTP 

08 USEP 

09 USEP 
11 MQNTP 
11 MONTP 
11 MQNTP 
11 MONTP 
13 USEP 
13 USEP 
13 USER 
13 USER 
58 USEP 
58 MONTP 
58 MONTR 
58 USEP 

58 USER 

59 USER 
59 USER 
59 USEP 
59 USEP 

59 LpDAT 

59 LPDAT 



BATCoN version 103C22Q7) running cobjob sequence 1072 in stream 1 
input from DSKBiCOBJOB,CTLl27,5031] 
Output to D3KBlCOBJQB t LOGC27,S031) 

Job parameters 

Tlm«|00|05|00 UnlqUCIYES RtitartlNQ QUtPUtlLOG 

.LOGIN 27/5031 /DEFER/SPOOLl ALL/TIME| 300/NAMEl "LAMAR.B" 

JOB 13 KI10 SYS 514C 603A TTY103 

CLGNjsp Otnar Jobs sam« ppnihJ 

[LGNrdu Recomputing disk usage] 

(LGNQTA DSKB INU0000 OUTI5000 USED11660] 

1234 02-AU9-78 Wed 

, .MOUNT MTAlMAGl/REELIDlSCRTCH/WENABLE 

Request queued 

waiting, ,,2 "C f i to Exit 

MAGI mounted, mtaooi used 

,, COMPILE MYPROG.CBL/LIST 
COBOLI MAIN [MYPROG.CBLJ 

EXIT 

,, EXECUTE MYPROG.CBL 

LINK| Loading 

[LN*xCT myproG Execution) 

EXIT 

, .DISMOUNT MAGI || 

[MTAoOllSCRTCH WRITECC/H/S) * 75130/0/0] 

Request queued 

waiting. , ,2 *C'i to Exit 

MTAOol Dismounted 

.KJOB/BATCH 

[LGTaJL Another job is still logged«in Under 127,5031]] 
job 13 User LAMAR, B 127,5031] 
Loqged»o<« TT"i03 at 12137159 on 2»Aug»78 
Runtime! 0100.04, KC5I76, Connect tlmei 1 03 1 33 
Disk Peadsi282, wrltesnoS 

LPTSpL ytrslon 103(2421) KIjO SYS 514C 603A 

job COBJOB Sequence *1072 on LPTOOQ at 2«Auq»78 12137159 
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5.2 USING CARDS TO ENTER JOBS 

ALGOL Example 

The first job is a simple ALGOL program that writes its output into 
the log file because it has statements that would cause it normally to 
write to the terminal. The program is as follows. 

BEGIN 

REAL X; INTEGER I; 

X :=1; 

FOR I :=1 UNTIL 1000 DO X:=X+1; 

PRINT (X) ; 
END 

The cards to enter this program are shown in Figure 5-1. 




$EOJ 



SEXECUTE 



ALGOL source program 



$ALGOL/NOLIST 



$PASSWORD password 



$JOB [27,5107] 



Figure 5-1 ALGOL Job Entry Card Deck 
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The output, including the log file, is shown below. 



13l39|16 STDAT 

13I39U6 STCRD 

13I39H6 8TCPD 

13I39H7 8TMSG 

13I39U7 STCPD 

13I39H7 STCPO 

1 3 1 39 1 1 7 3T5UM 

13I39U7 5TSUM 

13l39|17 5T5UM 



2-AUG-78 RK3A7A KL10 SYSM026 SPRINT VarSlOh 102(2024) 

IJOB 127,5107) 

SAIGOL/NOLIST 

File DSKILNON3L.ALG Craated • 6 Cards Read - 1 Bi e*i written 

■EXECUTE 

• EOJ 

End o< Job Encountered 

11 Cards Rtad 

Betch Input Request Crteted 



06 BAJOB 

06 BAFIL 

06 BAEIL 

06 BASUM 



06 
21 
22 
23 
23 
24 
24 
27 
27 
27 
27 
27 
29 
31 
32 
32 
32 
32 
32 

32 
32 
32 
33 
33 
33 
33 
33 
33 
33 
33 
55 
55 
55 
55 



MONTR 

MONTR 

USFP 

USER 

USER 

MQNTR 

MONTR 

USER 

MONTR 

MONTR 

MONTR 

MONTR 

USEP 

USER 

USER 

USER 

USER 

MONTR 

MONTR 

BLABL 

MONTR 

USER 

USEP 

USER 

USEP 

USER 

MONTR 

MONTR 

USER 

USEP 

MONTR 

MO^TR 

MQNTP 

MONTR 



batcon varslon 102(2067) running. J0BQN3K saquance 1259 in stream 1 

input «rom DSKC|*JB0N3K,CTL127,5107J 

OUtDut to DSKCIJBON3K.LCXJ127, 5107] 

Job p«r«meteri 

TimeiOOtOSfOO uniqueiYES pestartiYES output|LOG 

, LOGIN 27/5107 /DEFER/SPOOL I ALL/TIME | 300/LOCATE I 26/NAME I "BROWN # E« 
JOB 49 PK3A7A KMO 5Y5I1026 TTY5U 
[LGNjsp Other jobi feme PPN12U 

1343 02-AUO-78 Wfd 

,,COMPIL /COMP/ALG DSK|LN0N3L,ALG 
ALGOli LNON3L 

EXIT 

..EXeCUT /REL DSKlLNONjL.REL 

LINK| LoedlnQ 

ttNKxCT LNQN3L Execution) 

1,00100004. 3 

End of a*ecution, 



%ERRtl 
%FIN|| 

.DELETE DSKlLNON'jL.ALGjDsKlLNONSL.REL 
Filat daletedi 

LNONJL.ALG 

01 Blocks tread 

LN0N3L,REL 

01 Block! freed 

.KJOb/BATCH 

CLGTaJL Another job if still loggad*m Under C27»5107J] 

Job 49 User BROWN, E (27,5107} 

L09Q«d«off TTY511 at 13t43l55 On 2«Au9*78 

Runtin>ei 0i00i0i„ KCSin, Connect timei 0|00|32 

Disk paadsi64S# wrlteeuo 



BASIC Example 



The next example shows how to enter a BASIC program. You must precede 
the program commands with a $CREATE card so that the program will be 
copied into a file on disk. No $DATA card can be used because BASIC 
does not use the EXECUTE command and because the data is entered by 
means of the control file: the program requests data when it is 
running; it finds the data in the control file. For this program the 
final data item in the control file must be 2 so that the program can 
be concluded. The program is shown on the following page. 
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5 INPUT D 

10 IF D=2 THEN 100 

20 PRINT "X VALUE", "SINE", "RESOLUTION" 

30 FOR X=0 TO 3 STEP D 

40 IF SIN(X)=M THEN 80 

50 LET X0=X 

60 LET M=SIN(X) 

70 NEXT X 

80 PRINT X0,M,D 

90 GO TO 5 

100 END 

The cards to enter the program and run it are shown in Figure 5-2 



DSK:MYBAS.BAS 




$EOJ 



MONITOR 



R BASIC 



STOPS 10 



$EOD 



BASIC source program 



SCREATE MYBAS.BAS 



$PASSWORD password 



$JOB [27,5107] 



Figure 5-2 BASIC Job Entry and Run Card Deck 
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The output from the program will be printed in the log file because it 
would normally be printed on the terminal. The log file is shown 
below. 



131 


39| 


131 


391 


131 


39| 


131 


39| 


131 


39| 


131 


391 


131 


39i 


131 


39| 


131 


39t 


131 


39l 


13 


1431 


13 


1431 


13 


I43| 


13 


I43| 


13 


1431 


13 


1431 


13 


1 43| 


13 


|44| 


13 


|44| 


13 


|44| 


13 


|44i 


13 


144} 


13 


|44l 


13 


|44l 


13 


l44t 


13 


|44| 


13 


|44| 


13 


I44l 


13 


|44| 


13 


I44| 


13 


144 I 


13 


I 441 


13 


44| 


13 


|44| 


13 


I44| 


13 


|44| 


13 


|44l 


13 


|44t 


13 


I44| 


13 


1 441 


13 


|44| 


13 


1 44| 


13 


1441 


13 


1441 


13 


t 44i 


13 


|44| 


13 


t 441 


13 


t 441 


13 


44| 


13 


(441 


13 


1 44 | 


13 


1441 



19 
19 
19 
21 
21 
21 
23 
23 
23 
23 



5TDAT 
STCBD 
STCPD 
STMSG 
STCPD 
STCRD 
STCRD 
STSUM 
STSUM 
STSUM 



56 BAJOB 

56 BAFIL 

56 BAFIL 

56 BASUM 



56 MONTR 

56 MONTR 

57 USER 
10 U8ER 

10 USER 

11 MONTR 
11 MONTR 
11 USER 
11 USER 
11 USER 

11 USER 

12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 USER 
12 MONTR 
12 MONTR 



I44U2 MONTR 

I 44 112 USER 

I44H2 USER 

I 441 13 MONTR 

I 441 1 3 MONTR 

I44H3 MONTR 

I44H3 MQNTP 



2-AUG-78 RK3A7A KMO 8YS»1026 SPRINT Vtrilon 102(2024) 
•JOB (27,5107J 
•CREATE MYPAS.BAS 

nit nsKiMYBAS.BAS crt«t«d • U Csrds Rtsd « 2 Biocks wrltttn 

IE0D 

•TOPSIO 

• EOJ 

End f Job Encounttrtd 

26 Csrds Rt«d 

Batch Input Rtqutst Cro«t«d 

BATCoN vtrilon 102(2067) running JBON3M ssqutnct^ 1260 in ftr««m 1 

input from DSKCt JBON3M t CTlC27,5107) 

Output tO DSKClJBON3M,Ln<J(27,5i07] 

job p«r«mtttrt 

Tlmt|O0|O5|00 UnlqutlYES RtstlrtlYES QutputfLOG 

.LOGIN 27/5107 /0EFER/SPOOLIALL/TIMEI 30Q/LOCATEI 26/NAMEI "BROWN, E H 
JOB 49 RK3A7A KL10 SYS#IQ26 TTY51J 
(LGNjSP other Jobs •«mt PPN121] 
1344 O2«AU0*78 Wtd 

,,R BASIC 



READy, FOR HELP TYPE HELP, 

•OLD 

OLD rILE NAME»**DSK|MYBAS|BAS 

READY 

#RUN 



MYBA5 



X VALUE 



**tOl 
X VALUE 



7#,oni 

X VALUE 

7#2 



13144 



SINE 


SINE 


SINE 




02*AUG*78 



RESOLUTION 
0.1 

RESOLUTION 
0,01 

RESOLUTION 
0,001 



TIME| 0,09 5ECS, 

READY 
•MONITOR 



%ERR|| 

btnecF End of th« control riu whU* stsrching fo r ifin 

,kjob/batch 

(LGTaJL Anothtr j«b l» still loggsa^ln undtr [27,si07JJ 

Job 49 UStr BR0WM,E (27,5107] 

Loqq t d«ot* TTY5U «t 13I44U3 on 2«AuO>78 

Runtimtf otooioo, KCSI8, Conntet tjmti 0t00|16 

Disk R«sdf|88, Wrlt«SI6 
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EXAMPLES OF COMMON TASKS WITH BATCH 



FORTRAN Example 



The third example shows a FORTRAN program that prints output on the 
line printer. In the control file, you want to tell Batch to prevent 
execution if the program compiles incorrectly. 

C THIS PROGRAM CALCULATES PRIME NUMBERS FROM 11 TO 50. 
DO 10 1=11,50,2 
J = l 

4 J=J+2 
A=J 

A = I/A 
L = I/J 
B=A-L 
IF (B) 5,10,5 

5 IF (J.LT.SQRT (FLOAT (I) ) ) GO TO 4 
PRINT 105,1 

10 CONTINUE 

105 FORMAT (14, 'IS PRIME.') 
END 

The cards used to enter this program are shown in Figure 5-3. 



STOPS 10 



SEXECUTE 



$ERROR. GOTO END 




$EOJ 



END::! END OF JOB 



FORTRAN source program 



SPASSWORD password 



Figure 5-3 FORTRAN Card Deck That Prevents Execution 

on Error 
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EXAMPLES OF COMMON TASKS WITH BATCH 

Batch puts the following commands into the control file as a result of 
the cards you entered. 

.COMPIL /COMP/F10 DSK:LNON3F. FOR/LIST 

.IF (ERROR) .GOTO END 

.EXECUT /REL DSK : LNON3F . REL 

END: : IEND OF JOB 

. DELETE DSK : LNON3F . FOR , DSK : LNON3F . REL 

Program output is as follows. 

MAIN, INONJF.FOR FORTRAN V,5A<621> /KI 2-AUG-78 13141 PAGE 1 



00001 


C 


THIS PROGRAM CALCULATES PRIME NUMBERSt 


00002 




00 10 1*11,30,2 


00003 




J"l 


00004 


4 


J»J*2 


00005 




A«J 


00006 




A-I/A 


00007 




L»I/J 


00008 




BPA-L 


000P9 




IF(B)5,10,5 


00010 


5 


IF(J,LT,SQRT(FLOATCl))) goto 4 


00011 




PRINT 105,1 


00012 


10 


CONTINUE 


00013 


10S 


F0RMAT(I4, • 18 PRIME,') 


00014 




END 



SUBPROGRAMS CALLED 

SORT, 
FLOAT, 

SCALARS AND APRAY5 ( "•" NO EXPLICIT DEFINITION • "%" NOT REFERENCED J 

•B 1 «J 2 «A J ,80000 4 #L 5 
• I 6 

TEMPORARIES 

,00000 13 

MAIN, [ NO ERRORS DETECTED J 



11 


IS 


PRIME, 


13 


IS 


PRIME, 


17 


IS 


PRIMEi 


19 


IS 


PRIME, 


23 


IS 


PRIME, 


29 


IS 


PRIME, 


31 


IS 


PRIME, 


37 


IS 


PRIME, 


41 


IS 


PRIME, 


41 


IS 


PPI^E, 


47 


IS 


PRIME, 
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EXAMPLES OF COMMON TASKS WITH BATCH 



The log file produced by the job is shown below. 



3138156 STOAT 2-AUG-78 RK3A7A KL10 SYS* 10-26 SPRINT Verilon 102(20243 

3138158 STCPD UOB 127,5107) 

3l38|58 STCPD IFORTPAN/LIST 

3l39|01 5TMSG File DSK I LN0N3F .FOR Created • 14 CaTdi Read • 2 BloCKf Written 

3|39t01 STCRD IERR0R .GOTO END 

3l39|0t STCRD IEXEcUTE 

3l39|01 STCPD IT0PS10 

3139101 STCRD IE0J 

3139101 5TSUM End t Job Encountered 

3 I 39 t 01 5TSUM 22 Cardi Read 

3 1 39 1 01 STSUM Batch Input Rtqutit Created 



13|41|51 MONTR Job 49 Uier BROWN, E (27,5107] 

1 31 4 1 1 51 MONTR LOggtd.otf TTY511 at 1 3 1 41 1 5 1 on 2»Aug*78 

13I4H51 montr Runtimei OlOOiOi, KCSI25, Conneet timet 0100123 

13|4t|51 MONTR Dlitc Readll 1275, Wrltei|31 



13|41 


|27 


BAJOB 


13141 


I 27 


BAFIL 


13141 


127 


BAFIL 


13l4t 


127 


BA5UM 


13141 


127 


MONTR 


13141 


127 


MONTP 


13141 


129 


USER 


131*1 


131 


USER 


13141 


ril 


USER 


13141 


1 32 


MONTR 


13141 


1 32 


MONTR 


13141 


134 


USER 


13141 


1 43 


USER 


13141 


144 


MONTR 


13IM 


r 44 


MONTR 


13141 


144 


FALSE 


13141 


1 44 


MQNTR 


13141 


145 


USER 


13141 


|4T 


USER 


13141 


I 48 


USER 


13141 


1 46 


USER 


13141 


148 


USER 


13141 


148 


MONTP 


13141 


148 


MONTR 


13141 


148 


MONTR 


13141 


148 


8LABL 


13141 


48 


BLABL 


13141 


48 


MONTR 


13141 


49 


USER 


13141 


49 


USER 


13141 


49 


USER 


13141 


50 


USER 


13(41 


50 


USER 


13141 


50 


MONTR 


13141 


50 


MONTR 


13I4U 


50 


USER 


13141 


50 


USER 



BATCoN verilon 102(2067) running JbOnIe sequence 1256 In itream i 

Input from Ds*Cl JBON3E.CTL 127,5107) 

Output to DSKC!JBON3E,LOCt27,5107) 

Job parameter! 

Tlme|00|05|00 uniqueiYES ReetartiYES OUtputiLOG 

, LOGIN 27/5107 /DEFER/SPOOL| ALL/TlME| JOO/LUCATE I 26 /NAME | »BPOWN,E" 
JOB 49 RK3A7A KL10 SY5#1026 TTY511 
CLGNjgp other Jobi tame PPN121J 
1341 02.Aug«78 wed 

,,C0MPIL /COMP/F10 D5K|LN0N3F,F0R/LIST 

FORTpANt LNON3F 

MAIN, 



,IF(ERR0H) .GOTO END 
.EXECUT /REL DSK|LNON3F,REL 
LINK, Loading 
[LnkxCT LNON3F Execution] 

END OF EXECUTION 

CPU TIMEI 0,04 ELAPSED TIME| 0,37 

EXIT 



END|| 

JCND OF JOB 

%ERR,| 

%FIN,| 

.DELETE DSKlLNONSF.FOP^SKlLNONSF.REL 

Filet deleted! 

LNON 3 F,F0P 

02 biocki freed 

LNONjr.PEL 

02 Biocki treed 

,kjob/batch 

ILGTaJL Another job if still logged"ln under C27,51073J 
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EXAMPLES OF COMMON TASKS WITH BATCH 

COBOL Example 

The fourth example is a COBOL program that writes record output on a 
magnetic tape. To have a tape drive assigned and your magnetic tape 
mounted on it, you must make a request to the operator. Since you do 
not know which drive will be assigned to your job, you must assign it 
in your job with a logical device name. The TMOUNT command assigns 
the drive to your job and associates the logical name that you specify 
with the physical drive assigned. The TMOUNT command also informs the 
operator of the name or ID number that identifies the particular tape 
you want mounted. (Your tape should be given to the operator or 
stored at the central site before you submit your job.) The program 
is as follows. 



IDENTIFICATION DIVISION. 
ENVIRONMENT DIVISION. 
INPUT-OUTPUT SECTION. 
FILE-CONTROL. 

SELECT OUTFIL ASSIGN TPDRIV. 
DATA DIVISION. 
FILE SECTION. 
FD OUTFIL LABEL RECORDS ARE STANDARD 

VALUE OF IDENTIFICATION IS "INFIL DAT" 

DATA RECORD IS OUTREC 

BLOCK CONTAINS 20 RECORDS. 
01 OUTREC PIC X(80) . 
WORKING-STORAGE SECTION. 
77 A PIC 9999 USAGE IS COMP. 
PROCEDURE DIVISION. 
START. 

OPEN OUTPUT OUTFIL. 

MOVE ZEROS TO OUTREC. 

MOVE 1000 TO A. 
LOOP. 

WRITE OUTREC. 

SUBTRACT 1 FROM A. 

IF A IS GREATER THAN ZERO GO TO LOOP. 

CLOSE OUTFIL. 

STOP RUN. 

The cards to enter this job are shown in Figure 5-4 
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EXAMPLES OF COMMON TASKS WITH BATCH 



STOPS 10 



$EXECUTE 



COBOL source program 




$EOJ 



IENDOF JOB 



.DISMOUNT MAG1 



SCOBOL 



MOUNT MTB:MAG1/REELID:SCRTCH/WENABI_E 



.PLEASE MOUNT A SCRATCH TAPE" [ 



STOPS10 



SPASSWQRD password 



$JOB [27,5107] 



Figure 5-4 COBOL Program Card Deck Using Data From Magnetic Tape 

Batch puts the following commands into the control file for you. 

.PLEASE MOUNT A SCRATCH TAPE"[ 

.MOUNT MTB:MAG1/REELID:SCRTCH/WENABLE 

.COMPIL /COMP/COB DSK : LNON3H . CBL/LIST 

.EXECUT /REL DSK : LNON3H . REL 

.DISMOUNT MAGI: 

. DELETE DSK : LNON3H . CBL , DSK : LNON3H . REL 

The log file from your job is shown on the following page. 
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13 


391 


Ul 


391 


131 


391 


13 


39| 


13 


391 


13 


391 


131 


391 


13 


39| 


13 


391 


13 


391 


13 


391 


13 


411 


13 


411 


13 


411 


13 


1411 


13 


411 


13 


141 J 


13 


411 


13 


421 


1 J 


421 


13 


421 


13 


4?l 


13 


42 t 


t3 


421 


13 


421 


13 


421 


13 


42i 


13 


4?l 


13 


421 


13 


421 


13 


421 


13 


421 


13 


421 


13 


42i 


13 


421 


13 


421 


13 


421 


13 


421 


13 


421 


13 


421 


13 


421 


13 


421 


13 


423 


13 


421 


13 


421 


13 


421 


13 


42 | 


13 


421 


1 3 


421 


13 


42| 


13 


421 


13 


421 


13 


421 


13 


42| 


131 


421 


13] 


421 


13i 


421 


13l 


421 


131 


421 


13 


421 


13 


421 



EXAMPLES OF COMMON TASKS WITH BATCH 

04 STDAT 2-AUG*76 PK3A7A KL10 SY3M026 SPRINT V«rtlOn 103(2U24) 

04 STCRD SJOB [27,5107 J 

04 STCRD IT0P510 

04 STCPD ICOBOI 

10 STM3G File DSKlLNONJH.CBL Crttt«<* • 25 Cardl Read • 4 BioC* «rltttn 

10 STCPD IEXECUTE 

10 STCRD ITOPS10 

10 STCRD SEOJ 

10 STSUM End f job Encountered 

10 STSUM 36 Cards Read 

11 STSUM Batch Input Request Created 

52 bajob batCon version 102(2067) punning jbon3G sequence 1257 in stream 1 

52 BAFIL Inout trom DSKClJB0N3G,CTL 127,5107) 

52 BAFIL Output tO DSKC IJBON3G.LnG (27 ,51071 

52 Basum job oarameters 

Tlmt|O0|O5|O0 UntQUOiYES RestirtlYES OutPUtiLOG 

52 MONTR 

52 MONTR .LOGIN 27/510? /DEFER/5POQLI AlL/TlMfct 300/LOCATEI 26/NAMKI "BRQWN, E" 

53 USER JOB 49 PK3A7A KL10 SYSM026 TTY5U 
00 USER tLGNjSP Other JOPS •*»• PPNI2H 

00 USEP 1341 02«Aug*78 wed 

01 MONTR 

01 MONTP , 

01 BATCH .PLEASE MOUNT A SCRATCH TAPE*t 

01 MONTR .MOUNT MTB | MftGl /REELID | SCRTCW/WENABLE 

02 USEP Pequast queued 

03 user waiting,, ,2 •C's to exit 

24 USER MAGI mounted, MTB2M used 

24 MONTR 

24 moNTP ,,CQMPIL /COMP/COB PSK| LNQN3H,CBLVlIST 

?5 USER CUBOLI MAIN [LNON3H.CBLJ 

35 MONTR 

35 MONTR EXIT 

35 MONTP 

35 MONTP ,,EXeCUT /PEL DSK ILNONJH.REL 

36 USEP LINK, Loading 

38 USEP [LNKXCT LNON3H Execution) 

40 USER 

40 USER EXIT 

40 USER 

40 MONTP ,, DISMOUNT MAGil 

40 USEP IMTB264ISCRTCH wplTE(C/H/S) a 75t30'Q/QJ 
4i usfp Requast quauad 

41 usep watting, ,,2 *C»s to Exit 

41 USEP MTB264 Dismounted 

41 MONTP 

41 MONTR , 

JEND OF JOB 

%EPP,j 

41 BLABL *FIN,i 

41 MONTR .DF.LETE DSK | LNON jH ,CBL , DS* I LNON3H ,REL 

41 USER Files deletedi 

42 USEP LNONJH.CBL 

42 user 04 biock* freed 

42. USEP LNONjH.REL 

4? user 03 biocks freed 

42 MONTR 

42 MONTP .KJOB/BATCH 

42 USEP 

42 user [LGIaJL Another job is still loggad»ln under 127,51Q7JJ 

43 MONTP Job 49 user BROWN, E [27,5107] 

43 MQNTP Logged-off TTY511 at 13142143 On 2*Aug*7g 

43 montr Runtimei 0100102, KCSIJ3, Connect tlmti 0100*51 

5? montr nis< Peadsni68, writestil8 
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GLOSSARY 



Term 



ALGOL 



Alphanumeric 



ASCII Code 



Assemble 



Assembler 



Definition 

ALGOrithmic Language. A scientifically oriented 
language that contains a complete syntax for 
describing computational algorithms. 

Any of the letters of the alphabet (uppercase A 
through Z and lowercase a through z) and the 
numerals (0 through 9) . 

American Standard Code for Information 
Interchange. Its 7-bit code is used to create a 
series of alphanumeric or special symbols. 

To prepare a machine-language program from a 
symbolic-language program by substituting 
absolute operation codes for symbolic operation 
codes and absolute or relocatable addresses for 
symbolic addresses. 

A program which accepts symbolic code and 
translates it into machine instructions, item by 
item. The assembler for TOPS-10 is called the 
MACRO assembler . 



Assembly Language 



Assembly Listing 



BASIC 



Batch Processing 



Card 



The machine-oriented symbolic programming 
language. The assembly language for TOPS-10 is 
MACRO. MACRO statements are equivalent to one 
or more machine instructions. 

A printed list which is the byproduct of an 
assembly run. It lists in logical-instruction 
sequence all details of a routine showing the 
symbolic notation next to the actual 
instructions generated by the assembler. 

Beginner's All-purpose Symbolic Instruction 
Code. A timesharing computer programming 
language that is used for direct communication 
between terminals and computer centers. BASIC 
employs English-like terms, is relatively easy 
to use, and has a wide range of applications. 

The technique whereby a computer executes one or 
more programs in your absence. 

A punched card with 80 vertical columns 
representing 80 characters. Each column is 
divided into two sections, one with character 
positions labeled through 9, and the other 
with positions 11 and 12. The 11 and 12 
positions are not labeled and are also referred 
to as the X and Y zone punches, respectively. 



Glossary-1 



Term 
Card Column 

Card Field 

Card Row 



Central Processing 
Unit (CPU) 



Character 



COBOL 

Command 
Compile 



Compiler 



Computer 



Computer Operator 



Continuation Card 



Definition 

One of the vertical lines of punch positions on 
a punched card. 

A fixed number of consecutive card columns 
assigned to a unit of information. 

One of the horizontal lines of punch positions 
on a punched card. 

The portion of the computer that contains the 
arithmetic, logical, control, and I/O interface 
circuits. 

One symbol of a set of elementary symbols such 
as those corresponding to the keys on a 
typewriter. The symbols usually include the 
decimal digits through 9, the letters A, a 
through Z,z, punctuation marks, a space, 
operation symbols, and any other special symbols 
which a computer may read, store, or write. 

COmmon Business Oriented Language. A high-level 
source language widely used in business and 
commercial applications. 

An instruction that causes the computer to 
execute a specified operation. 

To produce a machine- or intermediate-language 
routine from a routine written in a high-level 
language. A high-level language is 
user-oriented and one in which single statements 
may result in more than one machine-language 
instruction, e.g., FORTRAN, COBOL or ALGOL. 

A system program which translates a high-level 
source language into a language suitable for a 
particular machine. A compiler converts a 
source-language program into intermediate- or 
machine-language. Some compilers used on 
TOPS-10 are: ALGOL, COBOL, FORTRAN. 

A device with self-contained memory capable of 
accepting information, processing the 
information, and outputting results. 

A person who has access to all software elements 
of a system and performs operational functions 
such as: loading a tape transport, placing 
cards in the card reader input hopper, removing 
printouts from the printer rack, etc. 

A punched card which contains information that 
was started on a previous punched card. 



Control File 



CPU 



The file made by you that directs Batch in 
processing of your job. 

See Central Processing Unit. 



the 



Glossary-2 



Term 



Definition 



Cr oss-Reference 
Listing 



Data 



Debug 



Disk 



A printed listing that identifies each reference 
of an assembled program with a specific label. 
This listing is provided immediately after a 
source program has been assembled. 

A general term used to denote any or all 
numbers, letters, and symbols, or facts that 
refer to or describe an object, idea, condition, 
situation, or other factors. It represents 
basic elements of information which can be 
processed or produced by a computer. 

To locate and correct any mistakes in a computer 
program. 



A form of a mass-storage device in 
information is stored in named files. 



which 



Execute 



File 



Filename 

File Extension 



FORTRAN 



To interpret an 
instructions and 
operation (s) . 



instruction or 
perform the 



set of 
indicated 



An ordered collection of 36-bit words composing 
computer instructions and/or data. A file can 
be of any length, limited only by the available 
space on the storage device and your maximum 
space allotment on that device. 

A name of 1 to 6 alphanumeric characters chosen 
by the user to identify a file. 

A string of 1 to 3 alphanumeric characters, 
usually chosen to describe the kind of 
information in a file. The file extension must 
be separated from the filename by a period, 
e.g., FOR01.DAT. 

FORmula TRANslator. A procedure-oriented 
programming language that was designed for 
solving scientific problems. The language is 
widely used in many areas of engineering, 
mathematics, physics, chemistry, biology, 
phychology, industry, the military, and 
business. 



Job 

Label 

Log File 

MACRO 

Mounting a Device 



The entire sequence of tasks performed between 
login and logout at an interactive terminal, 
with a card deck, or at an operator's console. 

A symbolic name used to identify a statement in 
the control file or in a magnetic tape file or 
in a volume. 

A file into which Batch writes a record of your 
entire job. This file may be printed as the 
final step in Batch's processing of a job. 

See Assembly Language. 

A request to assign an I/O device via the 
operator . 



Glossary-3 



Term 
Object Program 

Password 

Peripheral Device 

PPN 
Program 

Programming 



Project-Programmer 
Number 



Queue 



Software 



Source Deck 



Source Language 



Source Program 



Definition 

The program which is the output of compilation 
or assembly. Often the object program is a 
machine-language program ready for execution. 

The secret word assigned to you that, along with 
your project-programmer number, uniquely 
identifies you to the system. 

Any unit of equipment, distinct from the central 
processing unit, which can provide the system 
with outside storage or communication. 

See Project-Programmer Number. 

The complete sequence of machine instructions 
and routines necessary to resolve one or more 
computational tasks. 

The science of translating a problem from its 
physical environment to a language that a 
computer can understand and obey; also, the 
process of planning the procedure for solving a 
problem. This may involve, among other things, 
the analysis of . the problem, preparation of a 
flowchart, coding of the problem, establishing 
input-output formats, establishing testing and 
checkout procedures, allocation of storage, 
preparation of documentation, and supervision of 
the running of the program on a computer. 

Commonly referred to as PPN, these two numbers 
separated by a comma (,) identify you and your 
file storage area on a file structure. 

A list of jobs to be scheduled or run according 
to system-, operator-, or user-assigned 
priorities. For example, the Batch input queue 
is the list of jobs to be processed by Batch. 

The totality of programs and routines used by a 
computer. Examples include compilers, 
assemblers, operator programs, service routines, 
utility routines, and subroutines. 



A card deck that constitutes a computer 
in symbolic language. 



program 



The original form in which a program is prepared 
prior to its processing by the computer to 
produce the object-language program. 

A computer program written in a language 
designed for humans to use to express procedures 
or problem formulations. A translator 
(assembler, compiler, or interpreter) is used to 
translate the source program into an object- or 
machine-language program that can be run on a 
computer . 



System 



The collection of programs which schedules 
controls the computing facility. 



and 



Glossary-4 



Term Definition 

System Command An instruction to the system to perform an 

operation. The system commands for the TOPS-10 
are described in the DECsystem-10 (TOPS-10) 
Operating System Commands Manual. 

System Program A program generally available to users, 

administrators, or operators for performing some 
specific function. Examples are a FORTRAN 
compiler or a text editor. 

Terminal A device containing a keyboard, similar to a 

typewriter, and a printing or display mechanism 
employed to establish communications with a 
computer . 



Glossary-5 



INDEX 



! character, 2-3, 3-2 

$ character, 3-2 

% character, 2-10 

* character, 2-3, 3-2 

- character, 3-2 

. character, 

: character, 

3-4 
= character, 
"C characters, 2-4 
~ [ characters, 2-4 



2-3, 3-2 
2-11, 2-12, 

2-3 



$-language card, 3-1, 3-7, 

3-8 
$-language card examples, 

3-9 



/AFTER: switch, 2-6, 3-3 

ALGOL, Glossary-1 

$ALGOL card, 3-7, 3-8 

ALGOL example, 
card, 5-10 

$DATA, 3-14, 3-15, 3-16 
terminal, 5-1, 5-2, 5-3 

Alphanumeric, Glossary-1 

ASCII Code, Glossary-1 

Assemble, Glossary-1 

Assembler, Glossa -y-1 

Assembly Language, Glossary-1 

Assembly Listing, Glossary-1 



.BACKTO 

.BACKTO 

BASIC, 

BASIC e 

card , 

termi 

BASIC p 

3-2 

Batch, 

comma 

commo 

5-1 

contr 

3-2 

def in 

how t 

outpu 

submi 

2-5 



command, 2-12 

label, 2-12 
Glossary-1 
xample, 

5-11, 5-12, 5-13 
nal, 5-4, 5-5 
rogram card deck, 
4, 3-25 

nds, 2-8 

n tasks with, 5-1, 



ol card commands, 

ition, 1-1 
o use, 1-2 
t, 4-1, 4-2 
tting the job to, 



Batch jobs, 

cards, 3-1 

terminal, 2-1 
Batch Processing, Glossary-1 



Card, Glossary-1 

$-language, 3-1, 3-7, 3-8 

$ALGOL, 3-7, 3-8 

$COBOL, 3-7, 3-8 

$CREATE, 3-1, 3-5, 3-6 

$DATA, 3-1, 3-10, 3-11 

$EOD, 3-1, 3-16 

$EOJ, 3-1, 3-5 

$ERROR, 3-1, 3-18, 3-19 

$EXECUTE, 3-1, 3-9 

$FORTRAN, 3-7, 3-8 

$JOB, 3-1, 3-2, 3-3 

$MACRO, 3-7, 3-8 

$NOERROR, 3-1, 3-18, 3-19 

$PASSWORD, 3-1, 3-5 

$TOPS10, 3-1, 3-16, 3-17 
Card ALGOL example, 5-10 
Card BASIC example, 5-11, 

5-12, 5-13 
Card COBOL example, 5-16, 

5-17, 5-18, 5-19 
Card Column, Glossary-2 
Card deck, 

BASIC program, 3-24, 3-25 

program, 3-20, 3-21 

setting up your, 3-20, 
3-21 

using GOTO statement, 
3-30, 3-31 

using TOPS-10 commands, 
3-18 
Card decks for programs, 

3-23 
Card Field, Glossary-2 
Card format conventions, 

3-2 
Card FORTRAN example, 5-14, 

5-15 
Card job, 
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